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Objective Of This Module 

This Module offers an introduction to asseMbly language 
programing and the Atari Assembler Editor ♦ Through the 
activities in this nodule you will see how asseMbly language 
is a particularly good language for fast, sMooth animation* 
You also will find that asseMbly language requires 
programing in great detail* Upon coMpleting this nodule, 
you will not be prepared to write an arcade gane* Just as 
the novice pianist cannot hope to be able to write a piano 
concerto after two weeks of practice, a novice asseMbly 
language progranwer cannot possibly program a PAC MAN gane in 
two weeks* In fact, professional prograrwers with years of 
experience take six to eight Months to produce an arcade 
gane* Hopefully, you will find the rewards of a successful 
prograM are well worth the hard work* 



Overview 

1* The AsseMbler* 

What is the assenbler and what does it do? 

2* AsseMbly Language For Mat* 

What is the correct syntax and punctuation for 
asseMbly language prograMs? 

3* Instructions and Beginning Addressing Modes* 

This section offers you an opportunity to experiMent 
with various asseMbly language instructions* 

^* Indexed Addressing Modes* 

The eight different addressing Modes available 
on the Atari are explained and denonstrated ♦ 

5* Animation* 

In this section you will write asseMbly 
language subroutines that Move a spinning 
pinwheel around on the screen with a joystick* 



Prerequisite Concepts 

1. You Must have coMpleted the Machine Architecture Module 
before doing this Module* 

Mater ials Needed 

1* An Atari AsseMbler Editor Cartrigde and the User Manual* 
2* An Advanced Topics Diskette* 
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The AsseiMibler 



This section explains how assembly language programs are 
executed and the assembler editor's role in the process* 



In the Machine Architecture Module you recently 
completed, you had a chance to see some assembly language 
instructions and learn how the 6502 executes a program* You 
also learned that* regardless of what language you are 
programing in* the 6502 only understands machine code* How 
then does assembly language get converted to machine code in 
order for the CPU to execute your program? 

Writing and executing assembly language programs 
requires an "assembler editor ♦ " You have already used the 
Atari Assembler Editor cartridge to execute the assembly 
language programs in the Machine Architecture Module* When 
you insert your assembler cartridge in the Atari and turn on 
the computer* two programs on a chip inside the cartridge are 
loaded into memory* One of the programs* called the 
"assembler* 11 is responsible for converting your assembly 
language program to machine code* The second program* called 
the "editor*" enables the programmer to type and edit the 
assembly language program before it is "assembled" to machine 
code by the assembler* 

The assembly language program that a programmer writes 
and types into the computer is called the "source code*" The 
programmer uses the editor to insert* delete* or alter any 
part of the source code* The source code includes the three 
letter assembly language instructions* variable names* memory 
addresses ♦ and labels* Listed below is the source code for a 
program that prints an arrow in the upper left hand corner of 
the screen* The program simply loads the accumulator with 
the code number for an arrow* $7D* The *7D is then stored in 
screen RAM in order to print the arrow on the screen* 



*=$06G0 J ORIGIN OF PROGRAM 

LDA $$7D JLOAD ACCUMLATOR WITH CODE FOR AN ARROW 

STA *9C40 J SCREEN RAM LOCATION 

RTS J RETURN FROM SUBROUTINE 



If you look at the right hand side of the program* you 
will notice that the source code includes remarks and 
explanations about what the program does* These comments are 
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compsrsble to REM statements in BASIC* In assembly language 
you use 3 "J" to indicate that 3 remark follows* the sane way 
you use 3 REM in BASIC* However, connerits in assembly 
language sre Much wore vital than in BASIC because of the 
difficulty people have understanding assembly code* 



Before this assembly language program can be executed* it 
must be passed through the assembler* The assembler reads 
through the source code and converts the program to a 
numerical code which the microprocesssor can understand* 
<The assembler ignores the comments because they are not 
pertinent information to the CPU* The comments are only 
useful to the human reader who is trying to understand the 
program*) The result is called the "object code* 11 If you 
look to the left of the source code in the diagram below* you 
will see the object code* Note that the object code is 
listed in hexadecimal* The object code is also called the 
"machine code* 1 ' 



Object Code 



Source Code 



0000 

0600 A97D 
0602 SD409C 
0605 



0100 
0110 
0120 
0130 



*=$Q600 JORIGIN OF PROGRAM 

LDA **7D J LOAD ACC* WITH ARROW 

STA *9C40 J SCREEN RAM LOCATION 

RTS J RETURN FROM SUBROUTINE 



As the asseMbler converts the source code to object 
code* it stores the hexadecimal values in successive memory 
locations* The first instruction of the program* *=$0600* 
instructs the assembler to store the object code in memory 
starting at $600 * The column on the far left of the object 
code above holds the addresses of where the object code is 
stored in memory* The numbers just to the right of the 
memory addresses comprise the object code* which has been 
stored in memory* For a closer look at how the object code 
has been stored in memory* see the diagrsm below* 



Object Code in 
Memory 



$600 


I A9 


$601 


1 7D 


$602 


I 8D 


$603 


I 40 


$604 


I 9C 


$605 


I 60 



Source Code 



LDA $$7D 



-STA $9C40 




J LOAD THE ACC* WITH ARROW 
* t STORE ACC. IN SCREEN RAH 

J RETURN 
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A code number called the "opcode" has been stored in 
Memory for each instruction* For example, A9 is the opcode 
for the LDA instruction* The CPU recognizes the A9 as a 
"load the accumulator H instruction* The opcodes are called 
opcodes because they are the "code" numbers that tell the 
microprocessor which "operation 11 to perform* The 8D <STA) in 
memory location $602 instructs the CPU to store the value in 
the accumulator into the specified location* All opcodes are 
one byte in length* so they take up one memory location* 

The number following an instruction in the source code 
is called the "operand* 11 It is called the operand because it 
is the number the CPU will be "operating" on when it executes 
the instruction* For example* the $7D following the LDA is 
the number the CPU will load into the accumulator* This will 
be explained in more depth in the next section* However* 
note that the operand is stored in memory directly after the 
opcode for the instruction* Also note that the entire object 
code is listed in hexadecimal numbers* 

To summarize* the assembler converts the source code* or 
English-like version of the program* to object code* The 
object code is the hexadecimal version of the program* which 
the assembler stores in memory* It is also referred to as 
the machine code* The object code is the specific set of 
instructions that the microprocessor will execute* Turn to 
Assembly Language Programming Worksheet #1 to have a closer 
look at some source code and object code* 
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Assembly Language Programming Worksheet *1 



You will need an Assembler Editor Cartridge and an 
Advanced Topics Diskette to complete this worksheet* 

l# Boot up your system with the advanced topics diskette and 
the Assembler Editor Cartridge* You should have the "EDIT" 
prompt in the upper left hand corner of your screen* First, 
ENTER the 11 ARROW" program from your advanced topics diskette 
into your computer* 

Type: ENTER *D J ARROW 



2* Now type LIST* What type of code do you see? 



3* To execute the program* the source code Must be converted 
to object code by the assembler* 

Type: ASM and press RETURN 

The combined source code and object code should scroll 
up on the screen* The code you see on the screen should be 
the sane as the code listed below* 



If We know that the opcode for LDA is A9 and the opcode for 
STA is SD* What is the opcode for RTS?_ 



5* Mow let's run the program* 

Type: BUG and press RETURN 



You should see the word "BUG" on the screen* The Atari 
Assembler Editor executes the program from the "debugger*" 
The debugger is another program on the assembler cartridge; 
it enables you to look 3t or change the contents of specific 
memory locations* Don't worry if you don't understand this* 
However* if you would like to learn more about how to use the 
debugger* see chapter 5* "Using the Debugger*" of the 
Assembler Editor User's Manual* 



000 0 0100 

0600 A97D 0110 

0602 8D^09C 0120 

0605 60 0130 



*= $600 
LDA #*7D 
STA $9C40 
RTS 



J ORIGIN OF PROGRAM 

J LOAD ACC* WITH ARROW 

; SCREEN RAM LOCATION 

J RETURN FROM SUBROUTINE 
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6* Now you Must press the SHIFT and CLEAR keys 3t the saMe 
tiMe* This clears the screen* If you executed the prograM 
with an instruction at the bottoM of the screen * once the 
program had been executed, the screen would scroll up and 
arrow will no longer be visible* 

Type: SHIFT/CLEAR 

7* To execute the program you have to tell the computer 
where the object code is stored in Memory* 

Type: G6QQ and press RETURN 

The progrsM is stored at Memory location 600* So we use 
the "G" or GO coMMand to tell the computer to execute the 
prograM that begins at $600 



8* Try changing the character printed on the screen to 
another character by completing the steps below* First* you 
Must return to the editor* 

Type: X and press RETURN 

To see the source code again* 

Type: LIST and press RETURN 

By holding down the "CTRL'* key while pressing one of the 
arrow keys* you can Move your cursor up to edit your source 
code* Place the cursor over the 7 in the #$7D, following the 
LDA instruction* Type in another nuMber and press RETURN* 
Then go back to the debugger* to execute the program* by 
typing BUG ♦ Type SHIFT/CLEAR* to clear the screen before 
typing "G60 0 n to execute the prograM* The values for the 
internal character set are listed at the back of this Module 
if you want to experi Merit with putting specific letters on 
the screen* The values are listed in deciMal* so you Must 
convert them to hex3deciMal to use then in this prograM* 



9* To see how fast the CPU is putting the arrow on the 
screen* you can run a prograM called ARW2 on the Auxiliary 
Advanced Topics Diskette* See your instructor for a copy of 
the disk* ENTER the ARW2 prograM* 

Type: ENTER ARM2 

The ARW2 prograM loads the accuMulator with the value 
for an 3rrow* and then stores it in screen RAM* Just as the 
ARROW prograM did* However* the ARW2 prograM stores a zero 
in screen RAM where the arrow was placed to show how fast the 
arrow is displayed and then erased* AsseMble the prograM and 
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Type: ASM 



and press RETURN 



Type: BUG RETURN and G60 0 

Did you see it? Probably not* This short assembly 

language program is executed so quickly* you can't even see 
the arrow displayed* 
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Once the source code has been assembled to object code 
and the object code is stored in memory* how does the 
computer go about executing the program? You nay remember 
from the Machine Architecture Module that the CPU can only 
execute one instruction at a tine* To compensate for this 
the program is stored in memory and the CPU "fetches" one 
instruction at a time from memory ♦ The CPU goes through a 
repeated cycle of fetching instructions one at a time and 
executing them until the entire program has been completed* 
The actual set of steps the microprocessor takes to execute a 
program is called the "fetch cycle*" 



Fetch Cycle 

Fetch an instruction from memory * Get 
the opcode and an accompanying 
operand if there is one* 

Advance the program counter to 

the address of the next instruction 

to be executed* 

Execute the instruction ♦ 

Return to *1 and start the cycle over 
again ♦ 



1* 
2* 

^* 



First* the CPU fetches the instruction to be executed* 
Before executing the instruction* however* the CPU advances 
the program counter* a two byte register in the CPU* to the 
address of the next' instruction to be executed* Then the CPU 
executes the instruction it had previously fetched ♦ When the 
first instruction is completed* the CPU starts the cycle over 
again ♦ The program counter holds the address of the next 
instruction to be executed* A new instruction is fetched and 
the program counter is advanced again* Read along as we 
execute the fetch cycle with the ARROW program* 

It Fetch the instruction * The CPU fetches the first 
instruction of the program from memory* It knows where the 
first instruction is* because you gave it the starting 
address of he program when you typed "G60 0" ♦ When the CPU 
fetches the instruction from memory* it gets both the opcode 
and the operand* In the ARROW program the CPU fetches both 
A9 and 7D * The opcode A9 is the signal to the CPU to also 
fetch the value in the next memory location* Opcodes not 
only instruct the CPU on what type of operation to perform* 
they also indicate to the CPU how many bytes in memory are 
associated with th3t instruction* This will become clearer 
as you proceed through the module* Look at Diagram 1 below* 
The CPU is holding the A97D (LDA **7D) command* 
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2* Advance the program counter ♦ Before the A97D < LDA #*7D) 
is executed* the program counter Must be advanced to the 
address of the next instruction to be executed ♦ The next 
instruction of the ARROW program is the 8D (STA)* which is in 
rteMory location *602* Put the address of the 8D instruction 
in the program counter in Diagram 1* 

3* Execute the instruction held in the CPU ♦ Now execute the 
load command (A97D)* Load the accumulator in Diagram 1 with 
$70* 

*K Return to #1 and repeat the cycle.* Continue with the 
explanation of the fetch cycle below* 



Diagram 1. 
Source Code Object Code 
x=*06QQ 



LDA 


#$7D 


$60 0 


A9 






$601 


7D 


STA 


$9C40 


$602 


8D 






$603 


40 






$604 


?C 


RTS 




$605 


60 



6502 Processor 



COMMAND | A97D 



PROGRAM COUNTER 
ACCUMULATOR 



1 ♦ Fetch the next instruction * The CPU fetches the' next 
instruction based on the address in the program counter* The 
program counter has $602* so the CPU fetches the 8D (STA) 
instruction* This time the CPU fetches the two bytes in 
memory following the 8D in order to get the entire "store" 
command (STA $9C40)* The 8D was a signal to the CPU that the 
instruction was a store instruction and that the operand was 
two bytes* The reason the operand is two bytes in this case 
is that the operand is the address of screen RAM ($9C^0) and 
all addresses are two bytes* You may have noticed that the 
two bytes of the address have been reversed* so that the low 
order byte*40* is stored in memory before the high order 
byte* 9C* At this point it is not necessary for you to 
understand why the CPU does this* Just remember that 
whenever an address is stored in memory* the two bytes of the 
address are reversed* If you look at Diagram 2 below* you 
will see that the CPU holds the entire store command 
(8D4Q9C) * 

2* Advance the program counter ♦ The next instruction in the 
ARROW program is the RTS (60)* Place the address of the 
opcode 60 in the program counter in Diagram 2 before 
executing the previously fetched instruction* 
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3» Execute the instruction * Now the "store" command in the 
CPU is executed* In the Diagram below execute the 
instruction by storing the value in the accumulator in 
*9C40* When the arrow has. been stored in screen RAM, it 
appears on the screen* 

4* Return to #1 and repeat the cycle * Continue with the 
last fetch cycle of executing the ARROW program below* 



Diagram 2 



Source Code Object Code 



6502 Processor 



*«*060G 



LDA 


*$7D 


$600 


A9 






$601 


7D 


STA 


$9C40 


$602 


8D 






$603 


40 






$604 


9C 


RTS 




$605 


60 



COMMAND 8D4Q9C 



PROGRAM COUNTER 



ACCUMULATOR 7D 



1* Fetch the next instruction ♦ The address in the program 
counter is $605* so the opcode for RTS in $605 needs to be 
fetched* RTS is an instruction that does not require an 
operand* Consequently* the CPU only fetches one byte* The 
command the CPU fetches will always be one* two* or three 
bytes long* The CPU knows how many bytes to fetch from 
memory based on the opcode of the instruction* Place the 
opcode for the RTS instruction in the command holder in the 
6502 in Diagram 3 below* 



2* Advance the program counter ♦ Since the ARROW program does 
not contain any More instructions after the RTS instruction* 
the progran counter is reset to the address of the next 
instruction in the assembler to be executed* If the ARROW 
program had been initiated from another program* the program 
counter would return to the address of the last instruction 
executed in the original program* For example* the MESSAGE 
program in the Machine Architecture Module ran an assembly 
language program from a BASIC program* When the assembly 
language routine was completed* the BASIC program continued ♦ 
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3* Execute the instruction * Since we ran the ARROW progran 
froM the debugger* the CPU returns to the debugger* The 
ARROW prograw has been successfully cocipleted* 



Diagran 3 



Source Code Object Code 



6502 Processor 



*=$Q600 
LDA *$7D 



$600 
$601 
$602 
$603 
$604 
$605 



A9 
7D 
8D 
40 
9C 
60 



COMMAND 



STA $9C40 



PROGRAM COUNTER 



RTS 



ACCUMULATOR 



The coMPuter is truly an anazing Machine* but let's see 
if we can trick it by putting the value of an opcode into the 
position of an operand* Turn to. Assenbly Language 
Programming Worksheet #2* 
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Assembly Language PrograMMing Worksheet #2 



You will need an Assembler Editor cartridge and an 
advanced topics diskette to complete this worksheet* 



1 ♦ Boot up the systen and enter the ARROW program* 
Type: ENTER #D : ARROW 



2* LIST the program and assemble it* 

TypeJ ASM and press RETURN 

3* Note that the object code is listed by commands* So the 
two bytes for the LDA *$7D command are listed on one line 
(600 A97D)* The next line contains the three bytes for the 
entire STA $9C40 command (602 8D4Q9C) ♦ And the one lone byte 
for the RTS command appears on the l3st line of the object 
code (605 60)* When the A9 is in the position of the opcode* 
which is the first byte of the command* the computer knows 
that the A9 represents a load instruction* The computer also 
knows that the opcode is followed by a one byte operand* 
However^ what would happen if you put an A9 in the position 
of an operand (LDA **A9)? 



^* LIST the program again* Using the CTRL key in 
conjunction with the arrow keys* place the cursor over the 7 
in the LDA **7D command* Replace the 7D with A9 * 

Type: A9 and press RETURN 

Press BREAK a few times to get below the listing of the 
program before assembling the program* 



5* Assemble the program* 

Type: ASM and press RETURN 

The first line of the object code should read: 600 A9A9* 
The first A9 is the opcode for the LDA instruction* What 
will the computer do with the A9 in the operand? Run the 
program ♦ 

Type: BUG and press RETURN 

Type: SHIFT/CLEAR 

Type: Go 0 0 
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When you run the progr3M t you should see 3n inverse "I"* 
A? is the internal character set code for that letter* 



When a value is in the position of an instruction in the 
object code, the CPU treats the value as an instruction* 
Conversely* when the value is in the position of an operand 
in the object code the computer treats the value as an 
operand* In this program the operand is used as a letter to 
be printed on the screen* Thus* the opcode A9 tells the 
computer to load the accumulator with the value in the 
operand* which also happens to be an A9* and represents an 
inverse M I H * 



Instruction 



Opcode Operand 



0600 A9A9 0110 
0602 8M09C 0120 



LDA *$A9 J LOAD ACCUMULATOR 
STA $9C40 JSTORE A9 ON SCREEN 
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You have no doubt noticed that the source code of 
assembly language programs has a unique and structured 
formats The source code contains information in columns or 
"fields*" There are three fields: the label field, the 
command field, and the comment field* Each field is 
separated from the next with a space* The label field and 
the comment field are optional* 



Source Code Fields 
Label Command Comment 

BEGIN LDA #*7D J LOAD ACC* WITH AN ARROW 



The Label Field 



A label enables the programmer to assign b name to a 
command or to the beginning of a subroutine* A label must 
begin with a letter <A-Z)* and it can only contain letters* 
numbers* and periods* It is good practice to make labels 
descriptive* but also try to limit them to no more than eight 
characters* 

Suppose we put the label BEGIN in front of the LDA #*7D 
command in the ARROW program* And instead of having an RTS 
instruction at the end of the program* we replace it with a 
"JMP" instruction* A JMP instruction enables you to "jump" 
to a label* Look over the listing below* What do you think 
the program will do? 



*=*Q600 

BEGIN LDA #*7D JLQAD ACC* WITH AN ARROW 

STA *9C40 t SCREEN RAM 

JMP BEGIN J DO IT AGAIN 



Turn to Assembly Language Programming Worksheet #3 to 
see how to insert a label into the ARROW program and see 
what this new program does* 
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Assembly Lsnguaqe Programming Worksheet #3 



1* ENTER the ARROW progran on the advanced topics diskette* 

Type: ENTER *DJ ARROW 

2* LIST the program* Use the CTRL and arrow editing keys to 
place the cursor directly over the space bef ore the LDA 
instruction ♦ 

3* While holding down the CTRL key, press the insert key (in 
the upper right hand corner of the keyboard) five tines - 
once for each letter in the word BEGIN* Be sure there is a 
space between the label and the command ♦ 

Typet BEGIN and press RETURN 

4# Using the CTRL and arrow editing keys again* Move the 
cursor down over the "R" in the RTS instruct ion ♦ 

Type: JMP BEGIN and press RETURN 

Your listing should look like this* 



The numbers on the left are the decimal line numbers* 
They are there strictly for editing purposes* Just as in 
BASIC* every" line of code Must have a line number , and you 
C3n delete or insert lines using line nunbers ♦ 

5» Assemble and run the program* 

Type: ASM and press RETURN 
Type: BUG and press RETURN 
Type: G6G0 

6* You have created an infinite loop* You didn't have to 
type SHIFT/CLEAR because the infinite loop prevents the 
screen from scrolling* To stop the program you Must press 
the BREAK key. 

The label field is always separated from the command 
field with a space* If no label is being used* you must 
leave a space between the line number and the command field* 
The space indicates to the assembler that no label is being 
used ♦ 



010 0 *=*060 0 

0110 BEGIN LDA *$7D 

0120 STA $9C^f0 J 

0130 JMP BEGIN ; 



D t LOAD ACC* WITH AN ARROW 

t SCREEN RAM 

;do it again 
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The Command Field 



The "command" field follows the label field* The 
command field includes the instruction and the operand* The 
three letter instructions are also referred to as 
"Mnemonics* " 

• Command Field 

Mnemonic operand 
LDA #*7D 

There is always one space between the mnemonic and the 
operand in the command field* 



The Comment Field 



The third field is the ''comment' 1 field* Comments are 
optional but highly recommended* You will find in assembly 
language programming that even though you may know a program 
inside and out when you write it* when you go back to it a 
few days later* you will struggle to remember exactly how the 
program works if the code is not well documented* 

Comments are separated from the other fields with a " } " ♦ 
Comments can follow the command field or you can start a line 
with a "J" and devote the entire line to a comment* 



0100 t THIS PROGRAM PRINTS WHATEVER CHARACTER 

0110 JIS STORED IN THE ACCUMULATOR ONTO THE 

0120 * GRAPHICS 0 SCREEN* THE VALUES FOR 

0130 J THE INTERNAL CHARACTER SET ARE USED 

0140 JTO STORE A CHARACTER IN SCREEN RAM* 

0150 ; 

0160 *=$0600 

0170 BEGIN LDA **7D J LOAD ACC* WITH AN ARROW 
01S0 STA *9C4Q I SCREEN RAM 

0190 JMP BEGIN J DO IT AGAIN 



As long as comments are preceeded with a 11 J " * a comment 
can contain anything* (letters* numbers* symbols ♦ etc ♦ ) just 
like comments following a REM statement in BASIC* When the 
assembler converts the soure code to object code* the 
comments are ignored* 
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Fsuedo Opcodes 



You have probably 3lso noticed that the first line of 
every assembly language program you have seen thus far 
contains an "*" followed by an and an address (usually 

$0600 )♦ In assembly language you Must tell the assembler 
where in memory to store the object code of your program* 
The Atari uses an asterisk to set the starting address of the 
program's object code in memory* which is referred to as the • 
"origin" of the program* The equals sign is a "psuedo 
opcode A psuedo opcode is an instruction to the assembler* 
For example, "*=$060Q" instructs the assembler to set the 
origin of the program equal to *60Q* Psuedo opcodes are not 
translated into 6502 object code* They are instructions to 
the assembler* Turn to Assembly Language Programming 
Worksheet #4 to change the origin of the ARROW program* 
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Assewbly Language PrograMMing Worksheet #1 



1 * ENTER the ARROW proqr3M» 



2* LIST the progran and use the editing keys to Move the 
cursor up over the first "0" in the address ,, $0600 N on line 
0100 ♦ 



3* While holding down the CTRL key, press the DELETE key 
once* The DELETE key is in the upper right hand corner of 
the keyboard f The cursor- should now be sitting over the "6" 
in "$600 M * 



4* Now use the editing keys to Move the cursor to the space 
just past the last " 0 11 in "$60 0"* 

Typet 0 and press RETURN 

The first line of your prograM should look like the 
following * 

010 0 *=*A0 0Q 



5* Press the BREAK key a few tines to Move the cursor down 
below the prograM* Now assemble the prograM* 



6* Look closely at the addresses of the object code* They 
no longer start* with 600* The object code is stored in 
nenory starting at $6000 instead* And even though the first 
line of your prograM was "*=*6000 M f the first byte of the 
object code is A?, for the LDA instruction* The "nxs" psuedo 
opcode is only an instruction to the assembler* The 6502 
never processes it* 



7* Go into the degugger to run the prograM* What 
instruction will you use to execute this prograM? (Hint: 
"G" stands for go* and the nunber which follows is the origin 
or starting address of the prograM in MeMory*) 
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Up to this point we have been storing the object code of 
the assembly language programs on page six of memory 
($600-$6FF)* F'3ge six is a free area of RAM and a good place 
for short assembly language programs* As your programs get 
longer you can set the origin of your program to any address 
in the free RAM area between $20 G 0-$AQ 0 0 ♦ However ♦ if you 
are using $9C^0 - $A0Q0 for screen RAM, as we are throughout 
this module ♦ you should probably originate your program 
between $2000-$9G00* Also, if you use the USR function to 
run an assembly language program from BASIC ♦ you need to 
avoid having one program write over another in memory* 
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In assembly language it is possible to give a nawe to an 
address that you use in your program* For example* instead 
of using the address *9C / I0* we could assign the name SCREEN 
to the address ♦ Then any time we wanted to store a value at 
that address, we could just use the name SCREEN* To assign a 
name to a variable or an address* we must use the psuedo 
opcode* 

Constant and variable declarations are grouped together 
in assembly language programs and commonly follow the origin 
statement at the beginning of the program* Take a look at 
the example below* 



Note that the "S" in SCREEN is in the label field* All 
variable and constant declarations begin in the label field* 
one space before the command field* 

As this program is expanded* any time you want to refer 
to the address* $9C40* you can just use the name SCREEN* 
Using constant and variable names in programs makes a program 
much easier to understand* Also* whenever you go to change 
the address you are using* all you need to do is change the 
constant declaration at the beginning of the program* From 
then on the assembler treats the word SCREEN as the new 
address* Otherwise* you need to search through your program 
to find every instance in which you used the address $9C^0* 
As your assembly language programs get longer* locating all 
the instances of $9C^0 becomes an extremely arduous task* To 
experiment with assigning a name to an address and then 
changing that address* turn to Assembly Language Programming 
Worksheet #5* 



*~$060Q 
SCREEN = *9C40 
LDA **7D 
STA SCREEN 
RTS 



J START GR*0 SCREEN 
JLDAD ACC* WITH AN ARROW 
J PUT A ON SCREEN 
i RETURN 
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Assembly Language Programming Worksheet #5 



It ENTER the ARROW program on your advanced topics diskette* 
Type! ENTER #0! ARROW and press RETURN 



2* LIST the program* To insert a line that assigns the name 
SCREEN to $9C^0* we can just add another line number ♦ 

Typet 0105 SCREEN = $9C^0 and press RETURN 

\ // . 

Space 



3* Now we need to replace the screen address in the STA 
instruction with the word SCREEN* Using the CTRL and the 
arrow keys* Move the cursor up and place it over the $ in the 
STA $9C^Q instruction* 

Type: SCREEN and press RETURN 



4* Assemble the program* go into the debugger* and execute 
the program* Assigning a name to the screen address should 
not have affected the operation of your program in any way* 



5* If you have difficulties assembling your edited version 
of the ARROW program* load the SCRADR progr3fi on your 
advanced topics diskette* 



6* Experiment with changing the address of screen RAM you 
3re using* The addresses for the screen range froM $9C^Q to 
$9FFF* Use the CTRL and arrow editing keys to put the cursor 
over the addresss in the SCREEN = $9C^0 assignment* Change 
the address* Be sure to press RETURN after typing in a new 
address and Move the cursor down below the program before 
trying to asseMble it* Can you put the arrow in the middle 
of the screen? 

For purposes of explanation* the address of screen RAM 
will be used instead of the name SCREEN in the next couple of 
programs ♦ 
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The Most commonly used assembly language instructions 
will be explained and demonstrated in this section* Some of 
the addressing modes in assembly language also will be 
discussed* 



There are 56 instructions in the Atari 6502 instruction 
set* Each instruction consists of a three letter mnemonic or 
an abbreviation of the operation the instruction performs* 

The most common instructions are those that transfer 
data between the microprocessor and memory* All the data 
transfers that go on between the CPU and memory involve one 
of the internal registers* "Load" instructions transfer 
memory data into the accumulator* the X register* or the Y 
register* There is a set of three load instructions - one 
for each register* 

LDA* LoaD the Accumulator 
LDX ♦ LpaD the X Register 
LDY ♦ LoaD the Y Register 

You are familiar with the LDA instruction* 



SOURCE CODE 
LDA *$7D 



OBJECT CODE 




$600 
$601 



A9 
7D 



6502 
ACC* 7D 



The value immediately following the opcode for the LDA 
instruction in memory is stored in the accumulator* The "#" 
is referred to as an "immediate" symbol* So the LDA *$7D is 
read* "load the accumulator with immediate hexadecimal $7D*" 
Whenever you use a hexadecimal number* you must precede the 
value with a "$"♦ To use decimal numbers in a program* you 
simply forgo the dollar sign* LDA *125 is the same as LDA 
*$7D since decimal 125 equals hexadecimal $7D* The "*" 
remains because we are still loading the accumulator with the 
value immediately following the instruction* The load 
instructions for the X and Y registers function exactly the 
same way* LDX *$7D places hexadecimal $7D in the X register* 
LDY *$7D places a hexadecimal $7D in the Y register* Loading 
a register with 3 specific value is called "immediate 
addressing*" Immediate addressing is easily recognized by 
the "*" preceding the value bo be loaded into the register* 
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It is also possible to load 3 register with the contents 
of 3 memory location* Suppose you have 3 program that 
computes 3 msth problem snd stores the answer in Memory* 
When the prografi is done, you don't know what the answer is, 
but you do know the memory sddress of where the answer has 
been stored ♦ You need to be able to load a register with the 
contents of the address of the answer so you can find out 
what the answer is* Loading a register with the contents of 
a Memory location is called "absolute addressing* u In 
absolute addressing* the operand to the instruction is the 
address of the Memory location you wish to see* Study the 
diagram below to see how absolute addressing works* 



SOURCE CODE OBJECT CODE 



650; 



LDA $9C40 



$600 
(i601 
($602 



AD 
40 
9C 



.->ACC* 0 0 



{ 



$9C4Q 



00 



The zero stored in $9C40 is loaded into the accumulator* 
Since this is absolute addressing* the "*" is no longer used* 
Note that the opcode for the LDA instruction stored in $600 
is ''AD" ♦ Up until now the opcode for LDA has been A9* The 
opcode changed because the operation performed by the CPU is 
different* AD instructs the CPU to get the value stored in 
the specified memory location and load it into the register* 
The AD also instructs the CPU to fetch three bytes* one byte 
for the opcode of the instruction* and two bytes for the 
address in the operand* You needn't worry about what the 
specific values are of the various opcodes* or which opcodes 
represent which addressing modes* The assembler and the 
processor handle that for you* Our goal here* is to point 
out that the opcode indicates to the CPU the type of 
addressing being used and thus* wh3t operation the CPU is to 
perform ♦ 
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Assembly Language Programming Worksheet *6 



Turn off the computer and reboot your system to begin 
this worksheet* It is necessary for you to start with empty 
nenory 3nd empty registers* 



1, ENTER and LIST the ARROW program 



2* Use the edit keys to Move the cursor up over the LDA *$7D 
instruction* Change the instruction to read "load the 
accumulator with immediate decimal 64*" What number will be 

stored in the accumulator? Be sure to press 

RETURN after editing the LDA instruction* 

Assemble the program* go into the debugger ♦ and run the 
program (G600)* When the program stops* the registers will 
be listed* Were you right? 



3* Type X to go back to the editor and LIST the program* 

Now change the LDA *6^ instruction to LDA #298* What will be 

loaded into the accumulator? - Assemble the program* 

That was a trick question* You should have gotten Error 
111* Page ^3 of the Assembler Editor manual lists the error 
messages* Error 10 states* "the expression is greater than 
255 where only one byte is required*" Remember that one 
memory location holds a maximum of 255* If you try to load a 
number greater than 255 into the accumulator* the program 
will not assemble* 



^ * Now let's try some absolute addressing* LIST the 
program* Replace LDA #298 with LDA $600* What* value will be 

loaded into the accumulator? If you are unsure* 

assemble the program and then try to answer the question* 
The object code for the LDA instruction should appear as 
f ol lows ♦ 

0600 AD 00 06 0110 LDA $600 

LDA $60 0 loads the accumulator with the contents of memory 
location 600* What is the value in $600 which will be loaded 
into the accumulator? 



5» Run the program from the debugger and check the contents 
of the acuumulator against your answer* 
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6. Define the addressing Modes used below and explain what 
the instruction will do* 



LDA #*7D 



LDA *64 



LDA S9C40 
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Whenever you want to put 3 value in Memory *. you use 3 
n store n command* There are three store instructions ♦ one for 
esch register* 

STA: STore the vslue in the Accumulator in memory* 
STX* STore the value in the X register in memory* 
STY* STore the value in the Y register in memory* 

In the ARROW program the STA instruction was used to put 
the value for an arrow into memory location $9C40* (This is 
another example of absolute addressing* ) 



SOURCE CODE OBJECT CODE 



STA $9C40 



^8 



$600 8D 
$601 40 
$602 ?C 



6502 
ACC* 7D 



$9C40 



7D 



The $7D in the accumulator is stored into memory 
location $9040* Actually ♦ a copy of the $7D is made and 
stored in $9C4Q* The $7D in the accumulator remains 
unaffected by the STA command ♦ Turn to Assembly Language 
Programming Worksheet *7 to try the different load and store 
instructions* 
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Assembly Language Pr ogramming Worksheet #7 



You will need to turn off your Machine and reboot the 
system with an Assembler Editor cartridge and the advanced 
topics diskette in order to insure that the registers are all 
empty when you begin this worksheet* 



1* ENTER and LIST the ARROW program* 



2* Use the editing keys to place the cursor over the "A" in 
the LDA instruction* Instead of loading the accumulator with 
**7D, load the X register with #*7D* Type an M X M to replace 
the "A". 



3* If the value for the arrow is being loaded into the X 
register* then to print the arrow on the screen* we Must 
store the contents of the X register in screen RAM ( $9G4Q ) ♦ 
Change the STA command to a STX command* 



^* Assemble the code* Type BUG to get into the debugger* 
Type SHIFT/CLEAR* to clear the screen so the arrou won't 
scroll up off the screen* and run the program from $60 0 by 
typing G60 0* 



5* List the contents of the different registers below* The 
contents of the internal registers will be listed at the 
bottom of the screen once the program is completed* 

A= X= Y= 

As you can see* the program's performance does not 
change by using the load and store instructions for the X 
register* However* now the value for the arrow is stored in 
the X register instead of in the accumulator* Now let's 
investige where the #-&7D ends up when the program is 
executed * 

Type 4 * D9C^0 and press RETURN 

The "D" stands for display* We are displaying the 
contents of memory location $9C^0* 

You should see a 70 ♦ A copy of the 7D in the X register 
has been stored in $9C^0* 
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Let's get on with sone assembly language programing * 
You saw that a short assembly language program, which places 
an arrow on the screen is executed so quickly that you can't 
even see the arrow displayed* The alternative program we 
have used leaves the character on the screen* What good is 
assembly language if we can't control how long something will 
be displayed on the screen? What we need is a "delay loop*' 1 
which acts as a timer* Suppose we put the arrow on the 
screen and then we set a timer to count to 255* While the 
arrow is being displayed on the screen* the timer ticks away* 
When the titter gets to 255* the next instruction in the 
program is executed* 

To simulate a timer (or write a delay loop) we need to 
use an ''increment 11 instruction that adds one to a counter* 
There are three increment instructions* 

INC* Add one to the contents of a memory location* 
INX* Add one to the contents of the X register* 
INY* Add one to the contents of the Y register* 

Note that there is no increment instruction for the 
accumulator* The INC instruction will be explained later* 

The diagram below illustrates how the INY (INcrement the 
Y register ) instruction works* 

Y Register Increment Y Y Register 



0 0 > INY 



01 



01 I > INY > 02 



The 6502 handles the addition for you and stores the new 
value in the Y register* 

The X register can be incremented in the same way with 
the INX instruction* 

X Register Increment X X Register 



0 0 > INX > 01 
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The INX and INY instructions are self-sufficient 
commands* There is no operand necessary for INY or INX* 
When an instruction contains all of the information the CPU 
needs, it is called "implied addressing * " With the INY and 
INX instructions ♦ the object of the operation is the 
register, which is implied by the instruction itself* 



*=*Q600 

LDY *0 0 1 LOAD Y WITH 0 

INY J ADD ONE TO THE VALUE IN Y 

RTS t RETURN 



RTS is another example of an instruction that uses 
implied addressing* It does not require an operand* The CPU 
understands from the RTS instruction alone that it is to 
return to BASIC or to the program that called the routine* 

It is not possible to increment the accumulator* 
Instead* the third increment instruction enables you to add 
one to the contents of a memory location* For example* 
suppose you have a variable called "COUNTER" in your program 
and it is stored in memory location $CD* (*CD is a free 
memory location on the zero page of memory*) Look over the 
program below* 



*-*0600 

COUNTER = *CD J ASSIGN COUNTER TO $CD ' 

LDA #00 JLOAD ACC* WITH 0 

STA COUNTER J INITIALIZE COUNTER 

INC COUNTER J ADD ONE TO THE VALUE IN COUNTER 

RTS i RETURN 



COUNTER is initially set to 0* When the INC COUNTER 
instruction is executed* one is added to the value stored in 
COUNTER* It is also possible to place an actual address in 
the operand of an INC instruction* For example* in the 
program above* INC *CD would have served the same function as 
INC COUNTER* However* using variable names is highly 
recommended* Variable names make programs more 
understandable both to the programmer 3nd anyone else reading 
the program* Variable names also enable you to easily alter 
or update a program* To experiment with the increment 
commands turn to Assembly Language Programming Worksheet $8* 
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Assembly Language Programing Worksheet *8 



To begin this worksheet, you will need to turn off your 
Machine and reboot the system with an Assembler Editor 
Cartridge and the advanced topics diskette in order to insure 
that the registers are all empty* 



!♦ You should have the EDIT prompt on the screen* Type in 
the following program* Be sure to leave two spaces between 
the line nunber and the instruction for the label field ♦ 
Press RETURN after entering each line* 

100 *=$60 0 

110 LDY #*A0 

120 INY 

130 RTS 



Z* After running this program* what number would you expect 

to find in the Y register? Execute the program from 

the debugger and see* 



3* To get back to the editor t 



Type: X and press RETURN 



4> LIST the program* Using the editing keys* place the 
cursor over the value being loaded into the Y register (*AQ ) ♦ 
Replace the number with the values listed below* Fill in the 
boxes with the new values held in the Y register after 
executing the program* 



Y Register 



Y Register 



09 



FE 



INY 
INY 
INY 



When you incremented $FF, you should have gotten 0 0 in 
the Y register* $FF is the largest two digit hexadecimal 
number ♦ When one is added to $FF, the sum is $100 ♦ 



$ FF 
+ 01 
$ 1 0 0 
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Similarly* in base 10 (decimal)* 99 is the largest two 
digit number that can be represented ♦ Adding one to 99 
resets the two digits to 0 and carries a one over into the. 
next place value* Since registers and weMory locations in 
the Atari only hold one byte, when one is added to $FF* the Y 
register is reset to zero* 



5* In order to have a look at the contents of the Y 
resgister* step through the last program* which increments 
$FF* From the debugger* 

Type: S600 3nd press RETURN 

First f the LDY #$FF instruction is executed and the Y 
register is set to $FF* 

Typet S and press RETURN 

This tine the INY instruction is executed* At the 
bottom of the screen you should see the following* (Don't 
worry if the S for stack pointer does not equal 08*) 



0602 C8 INY 

A=00 X=00 Y=00 P=32 S=0S 



The "F-" stands for the processor status register* The 
status register is one of the internal registers in the 6502* 
The status register holds one byte* however* each bit holds 
significant information concerning the results of the CPU's 
most recently executed instruction* For example* if the last 
instruction left a negative number in one of the registers* 
the negative bit of the status register would be set* (The 
status register was first introduced in the Machine 
Architecture Module* See the Central Processing Unit section 
if you would like a review*) Each bit of the status register 
is called a flag 3nd it indicates if a certain condition 
exists in the processor* Currently* the status register on 
your screen should hold a 32 (P=32)* The binary 
representation of the status register below shows the bit 
pattern for the hexadecimal number $32* The ones indicate 
which bits of the status register are set* 



Status Reg i ster 



[ojo 



111 1 Q 0 i 1 0 

I I i 



N V - B D I z c 
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The "Z" bit, or zero flag, is set* The result of the 
last instruction (INY) left 3 zero in the Y register, and 
consequently the zero flag of the status register was set* 
(The ,, - ,t or unused bit and the "B" or the break bit were also 
set* These flags regain set as a program is executed* You 
needn't worry about why they are set*) The importance of the 
zero flag will become clearer in the next section* Don't 
worry if you are confused by the status register flags* They 
are typically difficult for beginners to understand* The 
status flags will become clearer the More you program in 
assembly language ♦ 
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Assembly Language Programming Worksheet #9 



There is also a set of "decrenent" instructions ♦ which 
are the opposite of increment instructions* 

DEX subtracts one from the value in the X register ♦ 

DEY one f r on the value in the 

register ♦ 

DEC subtracts one from the contents of a memory 
location* DEC COUNTER subtracts one from the value stored in 
COUNTER ♦ 



1 ♦ Use the editing keys to change the increment command in 
the increment routine* which you used in worksheet #8* to a 
decrement instruction as listed below* If you no longer have 
the increment program in memory* type in this new program* 

100 *=$60 0 
110 LDY **FF 
120 DEY 
130 RTS 

Assemble the program and run it from the debugger* Try 
the different values for the Y register listed below* Fill 
in the boxes for the result of the DEY instructions* 



Y Register 



Y Register 



FF 



DEY > 



F0 > DEY 



0 0 ! > DEY > 



Decrementing 0 0 should have given you $FF in the Y 
register ♦ In assembly language $FF stands for a minus one as 



look at the diagram below* 




1 
A 
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If you add $FF to 0, you get $FF ♦ If you subtract one 
from zero, you also get $FF* The processor knows whether $FF 
represents a Minus one or 255 according to the status 
register flags ♦ When one is subtracted from 0 0 , the result 
is $FF and the negative bit of the status register is set* 
When 255 is added to zero, none of the significant status 
flags are set* 



2* Step through the last decrement program, which subtracts 
one from zero* Type S6Q0* The contents of the registers 
will be listed as each instruction is executed* The Y 
register should hold 00, fron the LDY #$00 instruct ion ♦ 



3* Type S to execute the DEY instruction, and press RETURN ♦ 
The current contents of the registers will be listed* Fill 
in the registers below with what appears on your screen* 



0602 



88 



DEY 



A= 



X = 



Y = 



P = 



S = 



^* The status register (P) should have "BO" in it after 
executing the DEY instruction* Remember that the status 
register holds the status flags* Each bit of the status 
register holds significant inf or nation ♦ The binary bit 
pattern for B 0 and the status flags associated with each bit 
are shown below* 



Status Register 



01 1 



0 0 0 10 



H V ~ B D I z e 

t 

The "N" or negative flag has been set to indicate that 
decrementing 0 0 resulted in a negative number ♦ 



Don't worry if you don't understand the peculiar 
numbering system of the CPU ♦ 
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To set up 3 loop that repeatedly increments or 
decrements 3 register (or s counter) ^ we need to use 3 
"branch" instruction* The "BNE" instruction st3nds for 
Branch Not Equal to zero* BNE can be used to repeat a 
decrement instruction until the register has reached zero* 
Take a look at the short program below which uses a BNE 
instruction for a timing loop* 



SCREEN « *9C4Q 



LDY *$FF 
LDA **7D 
STA SCREEN 
DELAY DEY 
BNE DELAY 
RTS 



JSET COUNTER 
JCODE FOR AN ARROW 
{DISPLAY 

* SUBTRACT 1 FROM Y 

J IF Y IS NOT 0 * REPEAT DELAY 

J RETURN 



In the example above* as long as the Y register is not 
zero* the CPU will branch back to the label "DELAY" and 
decrement the Y register again* 

To determine if the Y register has reached zero* the BNE 
instruction checks the zero flag of the status register* 
When the register is decremented to zero* the zero flag of 
the status register is set* When the BNE instruction finds 
that the zero flag of the status register is set* the 
condition for branching when the register is not equal to 
zero is no longer in effect* The register is zero and so the 
branch is not taken* Instead* the next instruction in the 
program is executed* 

The 6502 instruction set has a series of branch 
instructions* each of which checks the current condition of 
one of the status flags* You can branch on a negative 
number* a positive number* a carry* etc* Below are the eight 
branch instructions available with the Atari assembler 
editor ♦ 



bcc: 


Branch 


bcs: 


Br anch 


beq: 


Br anch 


BMIJ 


Branch 


bne: 


Br anch 


bpl: 


Branch 


bvc: 


Branch 


bvs: 


Branch 



on Carry Clear 
on Carry Set 
on EQual to zero 
on result Minus 
Not Equal to zero 
on result PL us 
on overflow Clear 
on overflow Set 
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Branch instructions are very useful for short distance 
branches* as is the case with timing loops* However* it is 
not possible to branch long distances in a program* In a 
large program where a long branch is needed* the alternative 
to a branch instruction is a "JSR" ♦ Jump to a subroutine* 
JSR will be explained in the next section* 

Turn to Assembly Language Programming Worksheet #10 to 
see how a delay loop works in the ARROW program* 
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Assembly L3nQU3qe Programming Worksheet #10 



1* ENTER the HOLDARROW program on your advanced topics 
diskette* 

Type: ENTER *D J HOLDARROW and press RETURN 



00 0 0 010 0 *- 

9C^0 0110 SCREEN = 

0600 A000 0120 LDY 

0602 A97D 0130 LDA 

0604 8D409C 0140 STA 

0607 C8 0150 DELAY INY 

0608 D0FD 0160 BNE 
060A 60 0170 RTS 



$0600 
$9C40 

#$0 0 J SET COUNTER 

**7D > ARROW CODE 
SCREEN > DISPLAY 

JADD 1 TO COUNTER 
DELAY J IF NOT 0, REPEAT DELAY 

} RETURN 



2* LIST the program* It should look like the listing above* 
The Y register serves as a timer which counts to 255 while 
the arrow is being displayed on the screen* 



3* Assemble the program and execute it fron the debugger* 
You would think that because the computer has to count to 
255 ♦ the arrow would stay on the screen longer before the RTS 
forces the screen to scroll up* It doesn't look Much 
different does it? It is longer* though* Step through the 
program to see that the Y register is really being 
incremented 255 tines while the arrow is on the screen* Do 
the following* 

Typet S600 and press RETURN 

Continue to type M S" and RETURN a few tines to see the Y 
register being incremented • 



The branch instruction is always followed by 3 label to 
3n instruction which is close by in the program* There must 
be a short distance between the instructions because branch 
instructions use "relative addressing* 11 The object code for 
a branch command is two bytes* one byte for the instruction* 
and one byte for the "offset*" or the distance of the branch* 
The offset is the number of bytes in memory between the 
branch instruction and the instruction accompanying the label 
you are branching to* Look at the object code for the branch 
command in the HOLDARROW program listed below* 
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0607 C8 

0608 DOFD 



0150 DELAY 
0160 



INY 

BNE DELAY 



J ADD 1 TO COUNTER 

J IF NOT 0, REPEAT DELAY 



Memory location $608 holds, DO, the opcode for the E.'NE 
instruction* The FD in $609 is the offset to the label 
DELAY* FD, in this case, represents 3 decimal -3* The CPU 
nust look back three bytes in Memory to find the instruction 
associated with the label DELAY* Since the offset is one 
byte in the object code, the distance that is branched Must 
be held in one byte* Consequently, you can branch up to 128 
bytes forward <$00-$30), and 127 bytes back C$81-*FF) in a 
program and no further* Branch instructions are the only 
assembly language instructions that use relative addressing* 
The offsets in the object code are handled by the CPU ♦ All 
you need to worry about is branching too far in your 
programs * 
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A 1 1 r i ght s r eser ved * 



A longer delay is needed in order to leave the arrow on 
the screen for a longer period of tifie. To create a longer 
delay we will need to use another register* This second 
register will count the nunber of tines the first register 
counts frort 0 to 255* What we will do is "nest" the 0-255 
tiwing loop inside another loop* Suppose we load the X 
register with 25 and each tine the Y register counts froM 0 - 
255 the X register is decre«ented» This cycle is continued 
until the X register is zero* 




Here is the assenbly language version of the nested 
delay loops illustrated in the flow chart* 



DELAY LDX #25 
AGAIN LDY #00 
WAIT INY 

BNE WAIT 

DEX 



J COUNTER FOR Y LOOPS 
J 0-255 COUNT 
J ADD 1 TO Y 

J IF NOT 0, REPEAT WAIT 
J SUBTRACT 1 FROM X 



BNE AGAIN J IF NOT 0, REPEAT AGAIN 



RTS 



» RETURN 
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The delay loop is now 3 separate subroutine* which the 
ARROW routine will "call*" The advantage of waking the delay 
loop a separate subroutine is that it can be used fron 
any-where in an assembly language program ♦ As you have seen* 
assembly language is processed so rapidly that delay loops 
are connonly needed ♦ If the nested delay loop had been 
incorporated into the ARROW program, it could only be used 
when a character was being printed in the upper left hand 
corner of the screen* The secret to good assenbly language 
programing is to write versatile subroutines that can be 
reused within the program* 

Turn to Assembly Language Progr anting Worksheet #11 to 
exper inent with changing the length of the delay* 
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Assembly Language PrograMMing Worksheet #11 



1» ENTER the SUBROUTINE program on the advanced topics 
diskette. 

Type: ENTER *DJ SUBROUTINE and press RETURN 
The listing of the prograw should look like this: 



*=$60 0 
SCREEN = $9C40 
LDA #*7D 
STA SCREEN 
JSR DELAY 
7 RTS 



DELAY LDX #*A0 
AGAIN LDY #00 
WAIT INY 

BNE WAIT 

DEX 

BNE AGAIN 
^RTS 



JCODE FOR CLOVER 
J DISPLAY 
{WAIT 

;return 



JCOUNTER FOR Y LOOPS 



;o-; 



COUNT 



:add i to y 

{IF NOT 0, REPEAT WAIT 
{SUBTRACT 1 FROM X 
{IF NOT 0, REPEAT AGAIN 
{RETURN 



The "JSR" instruction, which stands for Jump to the 
SubRoutine, is used to call the delay routine. The RTS 
instruction at the end of the delay routine tells the CPU to 
go back to executing the instructions in the ARROW routine. 

2. The value stored in the X register controls the length of 
the delay. Assemble the progr3« and execute it froM the 
debugger to see how long the delay lasts. 

3. To return to the editor. 

Type: X and press RETURN 

^. Replace the *SA0 in the LDX #SA0 conM3nd with #$F0. 
Assemble and run the prograd froM the debugger. What effect 
did changing the value in the X register have on the delay? 
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A 1 1 r i g h t s r e s e r v e d . 



5* What would happen it you changed the value loaded into 
the X register to #$5? 



Try it and see, 



Copyright Atari* Inc« 1933* All rights reserved* 

^2 



SuMMary 



The 6502 offers eight different addressing Modes* The 
addresssing Modes that have* been covered thus far are listed 
below* 



iMMediate 
Absolute 
ImpI ied 
Relative 
Zero Page 



LDA **7D 
STA $9C40 
INX* RTS 
BNE AGAIN 
LDA *CD 



Zero page addressing is the saMe as absolute addressing* 
except that the address being accessed is on the zero page* 
Addresses on the zero page are listed as one byte because the 
high order byte of the address is "Q0 M ♦ The coMplete address 
of *CD is *00CD* When zero page addressing is used* the 
object code for the coMMand is only two bytes* one byte for 
the instruction ♦ and one byte for the address* The CPU 
assuMes that the high order byte of the zero page address is 
$00* Variables that are used frequently in a prograM are 
coMMonly stored on the zero page for quick and easy access* 
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This section covers the three renaining addressing Modes 
used in 6502 assembly language* Two of the three indexed 
Modes will be used in the final aniMation prograM* 

How about printing soMething a little More interesting 
than an arrow on the screen* Suppose you wanted to print 
four lines in succession* which would look like a stick 
spinning or a pinwheel* Four lines available in the internal 
character set are listed below* 





HEX 


DECIMAL 


1 = 


$7C 


124 


/ - 


$0F 


15 




$0D 


13 


\ = 


$3C 


60 



One possibility is to repeatedly load the accumulator 
with the values for each of the four lines* For example, we 
could write the following program* 



*=*600 
SCREEN = S9C40 
LDA **7C 
STA SCREEN 
LDA #$0F 
STA SCREEN 
LDA **0D 
STA SCREEN 
LDA **3C 
RTS 



J CODE FOR | 
J DISPLAY 
i CODE FOR / 
\ DISPLAY 
J CODE FOR - 
, DISPLAY 
JCODE FOR \ 
J RETURN 



It works, but this certainly is an inefficient way of 
going about printing a pinwheel* Instead, it would be 
preferable to have one set of instructions that printed a 
line on the screen* The code for the different lines would 
be passed through the printing routine* This would eliminate 
the repetition of LDA and STA instructions. In assembly 
language it is possible to set up a data t3ble and read 
through the data one element at a tine, just the way you can 
in BASIC ♦ 



Copyright Atari, Inc. 1983* All rights reserved* 

44 



To store the codes for these lines as data in neMory, the 
psuedo opcode "♦BYTE" can be used* The *BYTE command informs 
the assembler that what follows is a series of bytes which 
are to be stored in successive Memory locations* Not every 
assembler uses the *BYTE command* Some assemblers have 
different psuedo opcodes for saving data* To use the ♦BYTE 
command, the data Must be listed in decimal and separated by 
commas ♦ The *BYTE command that holds the data for the four 
lines is listed below* 



Label Instruction 
/ \ 

CHAR ♦BYTE 124,15,13,60 



CHAR is the label used to identify where the data is 
stored in memory* The data are listed in the operand of the 
command fields Each number in the list of data must be equal 
to or less than 255", since each element of data is stored in 
one memory location* When the assembler converts the source 
code to object code, an address is assigned to the label 
CHAR* If the address of CHAR is $060E, then the first 
element of data following ♦BYTE will be stored in $060E* The 
second element of data will be stored in $060F and .so on* 

Address Data 

$060E $7C 

$060F $0F 

$0610 $0D 

$0611 $3C 



Now that the data are stored in memory, we need to be 
able to get the numbers to be printed on the screen, one at a 
time* Reading through data in assembly language is 
accomplished with "indexed addressing ♦ 11 The X register or 
the Y register serves as an "index" for reading through the 
data* The following format is used for indexed addressing* 

LDA CHAR,X 

The number in the X register is added to the address of 
CHAR* The value in this new address is loaded into the 
accumulator* For example, suppose the X register contains a 
zero* 



LDA CHAR,X 
/ \ 
$060E + 0 = $060E 
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Zero is added to $060E* the address of CHAR ♦ The 
accumulator is loaded with the contents of this new address* 

Memory 65Q2 

X Register 0 
+ 

CHAR $060E 
*060E 



The first byte of data is stored in the accumulator* 
Suppose we incremented the X register to one* 



•60E 7C < -*Acct \~7C~ 

*60F OF 1 

*^10 OD x REG ♦ | 00 | 

$611 3C 



LDA CHAR*X 
/ \ 
$060E + 1 « $060F 



This tine the value in *060F is loaded into the 
accumulator ♦ 



Memory 



X Register 1 

CHAR $060E 
$060F 





Either the X register or the Y register can be used as 
an index* With indexed addressing you can access any one of 
255 elements of d3ta stored in memory* You are restricted to 
a maximum index of 255* because that is the largest number 
the X or the Y register can hold» Turn to Assembly Language 
Programming Worksheet *12 to see how you can incorporate 
indexed addressing and the *BYTE psuedo opcode into your 
assembly language programs* 
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Assembly Language PrograMMing Worksheet #12 



It ENTER and assemble the PINWHEEL progran on the advanced 
topics diskette • The listing on your screen should watch the 
listing below* (The first line will not show* ) 



0 0 0 0 




0100 


*=*60Q 


JORGIN 


9C40 




0110 


SCREEN = $9C4Q 


t SCREEN RAM 


0600 


A200 


0120 


LDX **00 


J SET INDEX TO 0 


0602 


BD0E06 


0130 


NEXTCHAR LDA CHAR,X 


J GET NEXT CHAR 


0605 


8D409C 


0140 


STA SCREEN 


t DISPLAY IT 


0608 


E8 


0150 


INX 


J ADD ONE TO INDEX 


0609 


E004 


0160 


CPX **4 


JCOMF : 'ARE X REG. TO 


060B 


D0F5 


0170 


. BNE NEXTCHAR 


J IF X <> 4 BRANCH 


060D 


60 


0180 


RTS 


} RETURN 


060E 


7C 


0190 


CHAR . BYTE 124, 


15,13,60 J DATA 


060F 


OF 








0610 


0D 








0611 


3C 









2* Have a look at the object code* 

3* What is the opcode for the LDA in the CHAR*X 

instruction? Another opcode for the LDA instruction! 

"BD" instructs the processor to take the contents of the X 
register* add it to the address of CHAR ♦ and store the 
contents of the new address in the accumulator* (The opcode 
also tells the CPU to fetch two bytes in the operand 
following the opcode BD* The two bytes following the BD in 
the object code are the address of CHAR*) 

^t* Now look down at the contents of *060E - $0611* These 
3re the bytes of data for the four lines that Make the 
pinwheel* Note that there is no opcode for the *BYTE 
instruction* Psuedo opcodes are instructions to the 
assembler* They are not processed by the CPU* Also note 
that the *BYTE instruction 3nd the pinwheel data are listed 
in the program following the RTS instruction* The data table 
must follow the RTS* because the data does not contain an 
instrucion or opcode for the CPU to execute* If the data 
came before the RTS* the CPU would try to interpret the data 
as opcodes to be executed* 

5* A new instruction appears on line 160* "CPX" is one of a 
series of "compare" instructions* 

CMP* CoM Pare Memory and the Accumulator 
CPX* CpmPare Memory and the X Register 
CPYJ Compare Memory and the Y Register 
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The branch instructions we used earlier in this nodule 
branched until either 0 or 255 was reached* Compare 
instructions enable the programmer to devise a loop with a 
termination point other than 0 or 255* CPX compares the 
contents of the X register with the number in the operand of 
the compare instruction* CPX compares the contents of 

the X register with 4 ♦ The comparison is made by subtracting 
the operand, *** from the value held in the X register* In 
the PINWHEEL program the X register is incr eemented just 
prior to the compare instruction* So the first time the CPX 
#4 is executed* the X register is one* 



CPX #*4 



01 X Register 
- <H Compare Operand 
-3 



The answer* -3* sets the negative bit of the status 
register* Compare instructions set the negative* zero* or 
carry bit of the status register* depending on the results of 
the subtraction* There is no other evidence of the 
subtraction or execution of the compare instruction* The 
number in the X register remains the same as it was prior to 
the compare instruction* When the X register is 
incremented to four and compared to the 4 in the CPX 
instruction* the result of the comparison is zero* 



CPX *4 



(H X Register 
-04 Compare Operand 
00 



The result of the comparison will set the zero flag of 
the status register* In the PINWHEEL program a BNE 
instruction is used to check the zero flag of the status 
register* Thus* the first through the fourth elements of 
data will be loaded into the accumulator and stored on the 
screen with indexed addressing* When the X register is 
incremented to ^ ♦ the BNE (branch not equal to zero) is no 
longer effective* The zero bit has been set* so the branch 
is not taken* and the next instruction in the program is 
executed ♦ 



6> Finally* let's run the program* 
Type: BUG RETURN G6 0 0 
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According to the way we h3ve planned the program* you 
should see the four lines displayed ♦ one right after the 
other f giving the appearance of one spin of a pinwheel* 
However * 311 we see is one line* We are up against a speed 
problem again* The computer is processing the program and 
displaying the lines so fast that all we can see is the last 
line* To be sure that each of the four lines is being 
printed* replace the RTS instruction at the end of the 
progran with a junp back to the beginning of the program* 
Use the CTRL and arrow keys to place the cursor over the "R" 
in RTS ♦ 

Type: JMP BEGIN and press RETURN 

The JMP instruction is sinilar to a GOTO in BASIC* 

To insert the label BEGIN* place the cursor over the 

space before the LDX *$()0 instruction* Hold down the CTRL 

key and press the INSERT key (in the upper right hand corner 

of the keyboard) five tines - once for each letter in the 
word BEGIN ♦ 

TypeJ BEGIN and press RETURN 

After you have typed BEGIN* be sure that there is a space in 
between the label BEGIN and the connand LDX* Using the CTRL 
and arrow keys again* Move the cursor down below the progran* 



7* Assemble the progran and execute it fron $600* At least 
we now know that each of the four lines is being stored in 
screen RAM as we intended* 
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To make the pinwheel look mare like it is sp inning ♦ we 
need a brief delay after displaying each line* Ideally, we 
would simply insert a JSR DELAY into the routine that draws 
the pinwheel* However * we must first review how each of the 
subroutines is using the registers ♦ It nay be that one 
subroutine changes a register and affects the operation of 
the second routine* Look over the listing below* Focus on 
the use of the X register* 

*-*60 0 J ORIGIN 

SCREEN » *9C^0 {SCREEN RAM 
♦ 

DRAW LDX #*Q0 J SET INDEX TO 0 

NEXTCHAR LDA,X J GET NEXT CHAR 

STA SCREEN ^DISPLAY IT 

JSR DELAY J CALL DELAY ROUTINE 

INX J ADD 1 TO INDEX 

CPX **4 {COMPARE X REG ♦ TO * 

BNE NEXTCHAR J IF X«4 THEN BRANCH FOR CHAR 

RTS } RETURN 
CHAR .BYTE 124,15,13,60 {PINWHEEL 

♦ 

♦ 
t 

DELAY LDX **A0 JCOUNTER FOR Y LOOPS 

AGAIN LDY #$00 \ 0 - *FF COUNTER 

WAIT INY t ADD 1 TO Y 

BNE WAIT J IF NOT Q, REPEAT WAIT 

DEX 1 SUBTRACT 1 FROM X 

BNE AGAIN J IF NOT 0* REPEAT AGAIN 

RTS JRETURN 



The X register is used as an index to CHAR and as 3 
counter in the DELAY loop* The DRAW routine sets the X 
register to zero and loads the accumulator with the character 
to be printed on the screen* Then a delay is needed* so we 
JSR DELAY* In the course of the DELAY loop* both the X and 
the Y registers are Manipulated* However * they are both at 
zero when the subroutine is completed* Thus* there is no 
conflict in the use of the X register the first time through 
the program* However* the Draw routine gradually increments 
the X register to index the line data* Suppose the X 
register has been incremented to one* When the DELAY loop is 
called* the X register is reset to zero* Immediately 
following the DELAY routine* the DRAW routine increments X* 
Consequently* the index to the data will be continuously 
reset to zero by DELAY and incremented to one in the DRAW 
routine* Since the X register would never get to four* the 
program would branch continuously and never stop* Thus* we 
need some way to preserve the index that reads through the 
data ♦ 
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This is 3 good opportunity to eMploy the "stack*" an area 
of Memory reserved for temporary storage of information* 
Before calling the DELAY routine, we will save the current 
value of the index on the stack* 

In the Machine Architecture module the "PHA" and "PLA" 
instructions were introduced* PHA stands for PusH the 
Accumulator onto the stack* PLA* PuLl the Accumulator off 
the stack* is used to retrieve the value from the stack* Any 
value to be put on the stack must first be put in the 
accumulator* So in order to save the X register on the 
stack* first we need to put the value in the X register into 
the accumulator* To shift a value from one register to 
another* we need to use one of a set of "transfer" 
instructions* 



TXA* Transfer the contents of the 

X register to the Accumulator* 
TAX* Transfer the contents of the 

Accumulator to the X register* 
TYA ♦ Transfer the contents of the 

Y register to the Accumulator* 
TAYi Transfer the contents of the 

Accumulator to the Y register* 



Transfer instructions make a copy of the value in one 
register and store that value in another register* as shown 
below* 



A copy of the contents of the X register is put in the 
accumulator* The X register remains intact* 

None of the transfer instructions require an operand* 
All of the information the CPU needs is evident from the 
instruction* so implied addressing is used* Glance over the 
use of the PHA* PLA* and the transfer instructions below* 



TXA 



X Register 



Accumulator 
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TXA J TRANSFER X INDEX TO ACCUMULATOR 

PHA J SAVE IT ON THE STACK 

JSR DELAY } CALL DELAY LOOP 

PLA J RETRIEVE INDEX FROM STACK TO THE 

{ACCUMULATOR 

TAX t TRANSFER INDEX FROM ACCUMULATOR TO X 

{REGISTER 



The index in the X register is transferred to the 
accumulator ♦ PHA pushes the index , which is now in the 
accumulator, onto the stack* (The stack fills from $01FF 
down to $0100,) 



Memory 



1. 
2. 



TXA 
PHA 



$0100 | 
$0101 | 



6502 



$01FE 
$01FF 



I 03 1^ 



v*ACC. 03 
^ X Reg. 03 



The JSR DELAY sends the CPU to DELAY to execute the 
subroutine. When the delay loop is completed , it returns the 
CPU to the instruction following the JSR DELAY in the DRAW 
routine. PLA retrieves the index from the stack and puts it 
into the accumulator. TAX transfers the index , in the 
accumulator, back to the X register. Turn to Assembly 
Language Programming Worksheet #13 to see how this sequence 
of instructions has been incorporated into the DRAW routine. 
This time the pinwheel will spin. 
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!♦ ENTER the SPIN progrsn on your advanced topics diskette* 
Type: ENTER *DtSPIN 



2* LIST lines 150 to 250 to see how the transfer commands 
have been incorporated into the DRAW routine* 



3* Assemble the program and execute it from the debugger* 



4 ♦ We can transfer the accumulator to the X register* and 
the X register to the accumulator* The Y register also can 
be transferred to the accumulator and vice versa* However* 
there is no instruction for transferring data between the X 
and Y registers* How can you transfer the X register to the 
Y register using the transfer commands you have learned? 
Write the assembly langauge code below* 



Command Comments 



Copyr ight A tar i * Inc * 1983 * 

nr »3 
JO 



All rights reserved* 



Spinning the pinwheel in the corner of the screen is 
fun* but how about putting that pinwheel soMewhere else on 
the screen? The graphics zero screen has 960 locations ♦ and 
so there are 960 Menory locations reserved, each of which 
correspond to one location on the screen* Up until now, we 
have been using $9C4Q* the "starting location" of the 
graphics zero screen* There are 40 locations per line and 24 
lines on the graphics zero screen* If you Multiply 40 by 24, 
you coMe up with the 960 locations on the screen Mentioned 
earlier* The 40 locations on the top row of the screen are 
numbered froM 0 to 39 in decinal* and correspond to Menory 
locations *9C40 - $9C67* The second row is nuMbered 40-79* 
The corresponding addresses are $9C68 - $9C8F* The address 
of the Middle of the screen is $9EQC* and the contents of the 
last location on the graphics zero screen is stored at $9FFF* 



Screen MeMory 



4 • 



* » 



*9C40 I 7C | 



*9C41 | 
*9C42 I 
*9C43 I 



I 



$9C67 | 



*9E0C | | 



*9FFF 
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In order to move the pinwheel around on the screen ♦ we 
need to be able to access any one of the 960 addresses <*9C40 
- $9FFF) in screen RAM ♦ One solution is to use "indirect 
indexed addressing* " Indirect indexed addressing requires 
that the address to be indexed is stored on the zero page of 
memory* Quite conveniently ♦ the starting address of screen 
RAM is stored in *58 and $59 on the zero page* (Memory 
locations *58 and *59 hold the starting address of the 
current graphics node in use* See the Internal 
Representation of Graphics and Text Module for an explanation 
of how the different graphics Modes use memory*) For our 
present purposes $90^0 is stored in $58 and $59 on the zero 
page* The low order byte of the address* ^0* is stored in 
$58* The high order byte of the address is stored in $59* 

Indirect indexed addressing uses the Y register as an 
index* An example of an indirect indexed instruction is 
listed below* 



First* the CPU gets the addresss contained in *58 and 
$59* When the CPU encounters an opcode for indirect indexed 
addressing* it automatically takes the low byte of the zero 
page address given in the instruction and looks for the high 
order byte of the address in the next memory location* The 
value in the Y register is added to the address* The STA 
instruction then stores the value in the accumulator into the 
new address* Look over the diagram of the STA <*58)**Y 
command below* 



Memory . l*Get the address stored in *58 and $59* 



STA <*58)*Y 




3*Store the acc* in the new address* 



contents of Y to the address* 



*9C40 
$9C41 
$9C^2 



*0058 
*0059 
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The STA instruction stores the accumulator in $9C40* 
Suppose the value in the Y register were incremented to one* 
To execute the STA ($58), Y instruction, first the CPU would 
fetch the 3ddress stored in $58 and $59* In our example the 
address is $9C40* Then one, from the Y register, is added to 
the address* The STA instruction uses this final address to 
store the accumulator in memory* Look over the diagram 
below* 



Memory 

$0000 | | 
♦ 

$0058 | 40 | x 

$0059 | ?C I \ 



$9C40 | | 
*9C41 | OF | < 
S9C42 I I 



^^l.Get the address stored in *58 and *59. 

^2»Add the contents of Y to the address* 
/ ,3 ♦ Store the acc» in the new address* 




650; 



1 


OF 


[ 




1 


01 


1 



The address stored in $58 and $59 has not been changed* 
(In the programs that follow, the names LOWSCR and HISCR have 
been assigned to $58 and $59, because they hold the. low byte 
and the high byte of screen RAM ♦ 

This is fairly difficult to understand at first* Don't 
panic* As you start programming in assembly language, you 
will see more applications for indirect indexed addressing, 
and it will become easier to understand* 

There is one remaining 6502 addressing mode, which will 
not be used in the final animation program* "Indexed 
indirect 11 addressing is one of the least common addressing 
modes in assembly language* Only the X register can be used 
as an index in indexed indirect addressing* An instruction 
using indexed indirect addressing looks like the this* 

STA ($58,X> 



The value in the X register is added to the zero P3ge 
address in parentheses* This new address contains another 
address* The accumulator is stored in this l3st address* 
Suppose the X register is 2 and the CPU is executing a STA 
($58,X> instruction ♦ 
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Memory 



$0000 

♦ 
♦ 

$0058 
$0059 
$005A 
$005B 



$9C4Q 
$9C41 
$9C42 
$9C43 



.l*Add the contents of X to the 
/ zero page address in the instruction. 




Get the address stored 
in Memory* 



3 ♦Store the accumulator in 
the new address* 




OF i 



Thus* the value in the X register is added to the zero 
page address in order to get another Memory address ♦ Indexed 
indirect addressing is useful when you wish to access a 
certain element of data from various equal sized data tables 
stored in memory* You needn't worry if you don't understand 
the indexed indirect addressing mode just yet* 
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In this section you will write the asseMbly language 
routines necessary to wove the pinwheel around on the screen* 
You also will learn how to read joystick data and Move the 
pinwheel in the direction the joystick has been pushed* 



First let's start by Moving the pinwheel to the right 
across the screen* To Move the pinwheel to the right* we 
need to add one to the pinwheel 's current address in screen 
RAM ♦ Since the Y register can only index up to 255 locations 
and we need to be able to access each of the 960 locations on 
the screen* the address of screen RAM on the zero page will 
be continually updated as the pinwheel is Moved* We will 
still use indirect indexed addressing* But* instead of 
increMenting the Y register* we will add one to the screen 
RAM address of the pinwheel 7 s current position* 

Adding is done with the "ADC 1 instruction* which stands 
for ADd with Carry* ADC adds the value in the ADC 
instruction operand to the accuMulator* ADC *$1* adds one to 
the value in the accuMulator* The ADC instruction also 
includes the contents of the carry bit (in the status 
register) in the addition* 



ADC *$i $7C AccuMulator $7C AccuMulator 

$01 Add Operand $01 Add Operand 

$01 Carry Bit SET $00 Carry Bit CLEAR 

$7E $7D 

Depending on whether the carry bit is set or not* the 
result of the addition will be $7E or $7D ♦ The sum of the 
addition is always stored back into the accuMulator* Unless 
you want to include the carry in an addition* you need to 
clear the carry bit to zero before adding* Clearing the 
carry bit will insure the accuracy of your addition* The 
"CLC" instruction is used to CLear the Carry flag of the 
status register* CLC uses iMplied addressing* No operand is 
needed* The asseMbly language code which adds one to the 
address of screen RAM is listed below* 



LDA 


LOWSCR 


CLC 




ADC 




STA 


LOWSCR 


LDA 


HISCR 


ADC 


#*0 0 


STA 


HISCR 


RTS 





J LOAD THE ACC. WITH THE LOW BYTE OF SCREEN RAM 
tCLEAR THE CARRY BIT TO 0 
J ADD 1 TO THE ACCUMULATOR 

J STORE THE ACC. IN THE LOW BYTE OF SCREEN RAM 
J LOAD ACC. WITH THE HIGH BYTE OF SCREEN RAM 
i ADD ZERO TO THE ACCUMULATOR 
I STORE THE SUM IN HISCR 
i RETURN 



Copyright Atari, Inc* 1933* All riahts reserved. 

53 



Does it seefi strange that one is added to LOWSCR and 
then zero is added to HISCR? Imagine the situation where 
LOWSCR is $FF and HISCR is $9C <$9CFF)* Now add one to 
LOWSCR ♦ 

Carry Bit =1 * FF 

$ 01 
$ 00 



The answer stored in the accuMulator will be zero and 
the carry bit is set* The new screen RAM address is $9C00* 
The high byte of the address ♦ (9C> * rewains the sane* 
However, $9C00 does not follow $9CFF in screen RAM — $9D00 
does* The carry bit needs to be added to the high order byte 
of the screen address* That explains the addition with 
HISCR* The carry bit was cleared before adding one to the 
low order byte of the address* If the carry was set by the 
first addition* a one will be included in the addition when 
zero is added to the high order byte of the address* 



LDA LOWSCR* ADC #*1 



LDA HISCR: ADC #$00 



Carry Bit=l 



FF 
1 
00 



$ 00 



LOWSCR 
ADC #$1 
CLC 



$9DQ0 



$9C HISCR 
$00 ADC #$00 

1 Carry 
$9D 



If the carry bit is not set by the first addition* zero 
is added to the high byte of the address* so it goes 
unchanged* 



LDA LOWSCR X ADC *$1 LDA HISCR { ADC **0 0 

Carry Bit=Q $ 40 LOWSCR $9C HISCR 

$ 1 ADC #$1 $00 ADC #$00 

$00 CLC _± Carry 

* 41 $9C 



$9C41 



Turn to Assembly Language Programing Worksheet #14 to 
see how this addition routine can be incorporated into the 
program to Make the pinwheel Move to the right across the 
screen* 
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Assenbly Language PrograMMing Worksheet #14« 



1 ♦ ENTER the ANIRIGHT prograM on your advanced topics 
diskette ♦ 

As your programs get longer and More coMplex, it becomes 
necessary to set up a "wain loop," which "calls" each of the 
subroutines ♦ 



2* To see the Main loop in the ANIRIGHT prograM, list lines 
120-180* 



Type: LIST 120,130 and press RETURN 



You will notice a list of JSR's to different subroutines 
in the program* The Main loop listed below has been inserted 
into the beginning of the program following the constant and 
var iable declarations ♦ 



BEGIN JSR DRAW J JUMP TD THE PIMWHEEL DRAW 

JSR DELAY JPAUSE WHILE DISPLAY PINWHEEL 

JSR RIGHT JMOVE THE PINWHEEL TO THE RIGHT 

JMP BEGIN t JUMP BACK TO BEGIN AND 

J RE-EXECUTE THE LOOP 



The first JSR DRAW draws the pinwheel in its starting 
position* The JSR DELAY holds the pinwheel in place 
Momentarily, so we can see it before it is Moved to the 
right ♦ JSR RIGHT calls the routine that 3dds one to the 
address of the pinwheel 's position on the screen* In order 
to see the pinwheel Move, we want to draw the pinwheel again 
in its updated position* Instead of adding another JSR DRAW, 
the next instruction, JMP BEGIN, sends the CPU back to the 
label BEGIN, and the first JSR DRAW is re-executed* The 
screen address has been updated, so the pinwheel is drawn in 
its new location* 



3* LIST ^50-550 and you will see that the add routine has 
been incorporated into the program* 

Type: LIST 450 * $50 and press RETURN 
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*K Don't forget that by adding the indirect indexed 
instruct ion * we have 3dded another use of the Y register to 
the progr3M» However * both the DRAW routine and the DELAY 
routine reset the Y register to zero* Thus, the additional 
use of the Y register does not effect the subroutines* 



5* Assemble and execute the program froM the debugger* 

The Main loop in this program is an infinite loop* To 
stop the prograM you need to press SYSTEM RESET* If you let 
the ANIRIGHT program continue past the last location in 
screen Memory* the program will continue to store the code 
for the pinwheel in successive nenory locations* The last 
address of the screen RAM is $9FFF* The assembler editor is 
stored in MeMory starting at $A000* If you let the ANIRIGHT 
program continue* you May write over the asseMbler editor in 
MeMory with pinwheel data* If this occurs* the EDIT proMpt 
will not coMe on the screen when you press SYSTEM RESET* In 
that C3se* you will have to reboot the systeM* 



6* Why are all those extra lines left on the screen? 



AniMating shapes in BASIC and asseMbly language requires 
the saMe sequence of steps* 



1* Set up the location for the pinwheel 

on the screen ♦ 
2* Draw the shape ♦ 

3* Hold the shape on the screen with a delay* 
^* Erase the shape* 
5* Repeat the cycle* 



The cycle is continued as long as the shape is being 
3niMated * 

In the ANIRIGHT prograM* we need an erase routine to 
draw over the last line of the pinwheel, before a pinwheel is 
drawn in the next position on the screen* To erase the line 
we will store a space in the pinwheel 's Most recent position* 
Look over the ERASE routine listed below* 
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ERASE LDY #*00 



I INDEX FOR ZERO PAGE ADDRESSING 
J CHARACTER CODE FOR SPACE 



LDA #$0 0 
STA (LOWSCR) 
RTS 



,Y ; STORE OVER LAST PINWHEEL 
J RETURN 



The ERASE routine is really quite sinple. Indexed 
indirect addressing is used to store the space in the 
pinwheel's Most recent position* Turn to Assembly Language 
Worksheet #15 to see how the ANIRIGHT prograM has been 
changed by incorporating the ERASE routine. 



C a P y r i q h t A fc 3 r i . I h c » 1 ? 8 3 , 



1 n 
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All rights 
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Assembly Language Progr3MMing Worksheet #15 



1* ENTER the progran called ERASE on the advanced topics 
diskette ♦ 



2* LIST lines 550-650 to see that the ERASE routine has been 
added* ERASE is called froM the Main loop* 



Typet LIST 550,650 and press RETURN 



3* Assenble the progr an and run it fron the debugger ♦ 
Renectber to press SYSTEM RESET to get back to the EDIT 
proMpt* Otherwise, you will have to reboot the systen* 



^* When the pinwheel reaches the right edge of the screen, 
it cones back on the left side of the screen, one line down* 
What do you think causes the pinwheel to "wrap around" the 
screen? 
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Now let's add joystick control* To Move the pinwheel 
with the joystick, you Must first know which direction the 
Joystick is being pushed. Values ere assigned to the 
different positions of the Joystick. 



14 



11 



10 T 6 



^ 7 



13 



When the joystick is pushed to the right* the number 7 
is stored in a memory location reserved for joystick 
feedback* Which memory location the 7 is stored in depends 
on which "port 11 (on the front of the Atari) the joystick is 
Plugged into* If the joystick is plugged into the first port 
on the far left* the 7 will be stored in memory location *278 
(632 in decimal) ♦ So to see which direction joystick *1 has 
been pushed* you simply need to read the contents of $278* 
The Memory addresses reserved for feedback from the joysticks 
plugged into ports one through four are listed below* 



Joystick in Port #1 $278 

Joystick in Port #2 $279 

Joystick in Port *3 *27A 

Joystick in Port #4 *27B 



One way to read the contents of a memory location is to 
load the accumulator with the value and do a series of 
comparisons* For example* LDA $273 loads the accumulator 
with the most recently depressed direction of joystick #1* 
To check the value we can compare the accumulator with the 
specific values we are looking for* If we compare the 
contents of the accumulator with 7 and find that the value is 
7* we know that the joystick has been pressed to the right* 
An assembly language routine that compares the joystick 
reading with the values for left and right is listed below* 



LDA **278 J READ JOYSTICK PORT #1 

CMP #$7 J IS IT A 7? 

BEG RIGHT J IF SO* BRANCH TO THE RIGHT ROUTINE 

CMP *«B J IS IT 11 

BEQ LEFT \ IF SO * BRANCH TO THE LEFT ROUTINE 
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Comparisons are only made with those values for the 
directions we are looking for* Any other value returned froM 
the joystick in *278 is- ignored* Thus* if the joystick is 
pressed on 3 diagonal* a 6 will be loaded into the 
accumulator* When the comparisons are made for a left or a 
right joystick press * the 6 will be ignored since the 6 does 
not match the 7 for right* or the 11 for left* 

RIGHT and LEFT are labels for subroutines which change 
the pinwheel's direction of travel* Turn to Assembly 
Language Worksheet #15 to see how the joystick reading 
routine can be incorporated into the program* 
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1 ♦ ENTER the JOYMQVE progran on your advanced utilities 
diskette ♦ 



LIST lines 150-220* 
Typet LIST 150,220 and press RETURN 



A JSR JOYSTICK coMMand has been added to the main loop * and 
the RIGHT routine is no longer there ♦ The JOYSTICK routine 
gets directional feedback f row the joystick* Instead of 
being called frow the Main loop, the RIGHT routine is called 
froM the JOYSTICK routine, whenever the person using the 
program pushes the joystick to the right* 



3* LIST lines 10 0-150 to see how the nane "STICK" has been 
assigned to the address $273 in the constant and variable 
declarations at the top of the program* For anyone reading 
through the program the nana STICK is Much easier to 
understand than the hexadecimal address $278* 



^* We have a routine to Move the pinwheel to the right* Now 
we need a routine to Move the pinwheel to th left* Since the 
addresses of each row of screen MeMory are numbered froM left 
to right* instead of adding, we need to subtract one froM the 
screen address in order to Move the pinwheel to the left* 



$?M0 | Subtract ^— *— •> Add 
I 

I You are here 

I 



When we wrote the add routine, first we had to clear the 
carry bit of the status register with the CLC instruction* 
The opposite is true for subtraction ♦ Before subtracting you 
need to set the carry bit with an "SEC" instruction* This is 
d ue to a p e c u 1 :L a r i t y o f t h e C P U ' s ri u m b e r i n g s y s t e m * I f y o u 
would like an explanation of why you Must set the carry bit 
before subtracting;- see Chapter ? of T h e ft t a r i As se n bler ♦ by 
D o ri a n d K u r t I n M a n > T i i e r e a r e c o p i e s i n 1 h e c a n p 1 i b r a r y ■> 
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The format of the subtraction subroutine is identical to 
the addition routine* The carry bit is set with SEC * The 
"SBC", SuBtract with Carry instruction, subtracts the number 
in its operand froM the accumulator* The result is stored 
back in the accumulator* "Double precision" arithmetic, where 
the high byte of an address Must be updated based on the 
results of the low byte arithmetic, is repeated in this 
routine* Try writing your own routine which moves the 
pinwheel to the left* 



5* LIST lines 30 0-380 to review the RIGHT routine* Now try 
writing a left routine below* 



LEFT i LOAD THE ACC* WITH LQWSCR 

SEC JSET THE CARRY BIT 

t SUBTRACT $1 FROM THE ACGUMLATQR 

t STORE THE ANSWER IN LOWSCR 

;load the accumulator with HISCR 

; SUBTRACT ZERO FROM VALUE IN ACC* 

t STORE THE ANSWER IN HISCR 

J RETURN 



LIST lines 390-^60* to compare your subroutine with the 
LEFT routine in the JQYMOVE program* 



6* Assemble the program and run it from the debugger* You 
should be able to move the pinwheel to the right or left with 
the joystick* Since there is no UP or DOWN routine* the 
pinwheel will not respond when you press the joystick in 
those directions* The program is in a continuous loop* which 
reads the joystick and moves the pinwheel continuously* You 
must press SYSTEM RESET to stop the program* You will be 
returned to the editor* How can you change the program so 
that it is not an infinite loop? • • 
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7« LIST lines 90-150* Note that a JMP BEGIN coMMand has 
been added ♦ The assembler goes through two steps to assemble 
an assembly language prograM* First, it reads through the 
program and assigns Menory addresses to each of the 
constants ♦ variabl ss ^ and 1 a bels« In this first step a 
"syfibol table" of the addresses is compiled by the assembler* 
SoMe assemblers list the symbol table after a program is 
assembled* If not# the symbol table remains hidden from the 
assembler user * as is the case with the Atari assembler ♦ The 
assemblers second step is to execute each instruction in the 
program starting with the first instruction in the object 
code* The JMP instruction tells the assembler to jump over 
the constant and variable declarations at the beginning of 
the program and go directly to the first instruction of the 
program* This is not a essential procedure and it will not 
affect the performance of your program* SoMe programmers 
like to insert the JMP instruction in the beginning of their 
programs for style and clarity* 
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AsseMhly Language PrograMMing Worksheet #16 



Now all we need are two routines that wove the pinwheel 
up and down* 



1 ♦ The subroutine that Moves the pinwheel down one line is 
identical to the RIGHT routine* except for the nunber that is 
added to the LOWSCR address* If there are forty spaces per 
line* how Much should be added to the LOWSCR address to Move 
the pinwheel down one row? 



2* LIST lines 300-380 of the JOYMQVE prograM to review the 
RIGHT routine* Try writing your own DOWN routine* Fill in 
the blanks below* 



DOWN J LOAD THE ACCUMULATOR WITH LOWSCR 

t CLEAR THE CARRY 

JADD one to acc* * include the carry 

— sta, lqwscr _„; 

t load the accumulator with hiscr 

adc **qo ; 

i store the accumulator in hiscr 

; RETURN 
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3. Now write a routine that will wove the pinwheel UP the 
screen . 



UP t LOAD THE ACCUMULATOR WITH LOWSCR 

SEC ?SET THE CARRY BIT 

> SUBTRACT ONE TO THE ACCUMULATOR 

> STORE THE ACCUMULATOR IN LOWSCR 

t LOAD THE ACCUMULATOR WITH HISCR 

t ADD ZERO AND THE CARRY BIT TO HISCR 

\ STORE THE ACCUMULATOR IN HISCR 

J RETURN 



^. The last set of instructions that need to be updated 
before the animation is coMplete is the joystick routine * 
The UP and DOWN routines need to be included in the JOYSTICK 
reading routine. The current listing of the JOYSTICK routine 
is printed below, CoMplete the conparisons and branches to 
the UP and DOWN routines. 



JOYSTICK LDA STICK J LOAD ACC. WITH JOYSTICK PRESS 

CMP #*7 {COMPARE THE FEEDBACK TO 7 - RIGHT 



BEQ 


RIGHT 


;if 


CMP 




J TO 


BEG* 


LEFT 


;if 






;is 




UP 


;if 




t*c 


?is 



iE ACCUMULATOR m 13? 

D 0 W M 1 IF SO THEN BRANCH TO DOWN 

t RETURN 



5* ENTER the ANIMATE prosraw on your advanced topics 
di skette ♦ 



C o p y r 1 9 h t A t a r i f I n c ♦ 



1983* 
73 



All rights reserved* 



6* LIST lines 510-660 to conpsre your DOWN and UP routines 
with the ones in the ANIMATE program You will not be able 
to see the entire listing at once* Instead you will have to 
list the subroutines individually* 



7* LIST 250-350 to check your JOYSTICK routine against the 
one in the ANIMATE program* 



8* And finally - assemble the program and try it out* 



The pinwheel Moves in each of the four directions* 
you Move it left or right and the pinwheel goes off the 
screen* it cones back on the screen on the opposite side 
This is because screen Memory is sequential 
the next on the screen* The address 
position on the top row of the screen is Just before the 
leftmost position on the second row of the screen* 



from one ro- 
of the rightmost 



When 



to 




Screen Memory 



$9C<H) | 
$9C^:L | 



$?C67 | 
$9C68 | 



$9C90 
*9C91 



When you Move the joystick up or down off the screen* 
peculiar things happen on the screen* This is because the 
pinwheel has noved out of screen RAM and is storing pinwheel 
data in areas of Memory being used for other purposes* The 
prograM never checks where the pinwheel is in memory* it Just 
adds or subtracts ^0 from the pinwheel ' s current address or 
position* ReMeMber t all that exists in Memory is a long 
string of boxes * each holding one number ♦ It is the sequence 
ad the CPU's interpretation of those numbers* that enables 
the computer to do such amazing things* If we store the 
values for the pinwheel and then erase the pinwheel in memory 
locations outside of screen RAM we are leaving zeros 
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in areas of Memory that Might have held important data or 
instructions for the CPU* Thus, when you Move the pinwheel 
up or down off the screen f you nay he writing over the data 
in Memory, which is there for other purposes, and you nay 
confuse the computer so Much that SYSTEM RESET will not 
return you to the EDIT proMpt* Instead, you will have to 
reboot the system* 
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In conclusion, we have set aside areas of nenory to 
serve different functions* The zero page holds the screen 
RAM address, which we access with indirect indexed 
addressing* Menory locations $600-$689 hold our progran. 
And we are using nenory locations $9C40-$9FFF to hold the 
data for what is being displayed on the screen* While the 
nunbers in these nenory locations bear significance to us. 
the progranners and the CPU » to soneone who is unfaniliar 
with conputers or assenbly language progranning nenory 
contains just a long, LONG, list of unintelligible nunbers. 



Use of lienors 
$0000 I 



Contents of henory 
$0000 I 00 I 



$0058 ILOWSCRI 
$0059 IHISCR I 



Zero Page 



$0058 I 
$0059 | 



40 | 
9C I 



$0600 
$0601 



I JMP I 
I BEGIN I 
I ADDRES 1 



$0600 | 
$0601 | 
$0602 | 



4C | 
03 | 
06 | 



$0650 
$0651 
$0652 



I LDA I 
ILOWSCRI 
I CLC I 



$0686 I DEX I 
$0687 | BNE | 
$0688 | OFFSET | 



> Aninate 
f Progran 



$0650 | 
$0651 | 
$0652 | 



$0686 | 
$0687 I 
$0688 I 



A5 I 
58 | 
18 | 



CA | 
DO I 
F8 I 



$9C40 
$9C41 
$9C42 



7C 



$9C40 
$9C41 
$9C42 



7C I 
00 I 
00 | 



f Screen Ran 



$9CFE 
$9CFF 



$9CFE I 00 | 
$9CFF | 00 | 
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3 im M3ry -3 a~n trf 



Chal X e r*a «q @ -s 



6502 Addressing Modes 



Immediate ? LDA #$50 JLoad the accumulator with 

immediate $50 t 

Absolute ♦ LDA $278 J Load the accumulator with the 

contents of memory location 
$2784 

Zero Page t LDA $80 JLoad the accumulator with the 

contents of the zero page 
location $80* 



Zero Page*Xt LDA $58, X 
Zero Page*Yt LDA $58, Y 



J Load the accumulator with 
the contents of $5S+X* 

JLoad the accumulator 
with the contents of $58+Y* 



Implied ? CLC J Clear the carry bit* Increment 

the X register by one* 

Relative t BNE WAIT J Branch to WAIT as long as the zero 

bit of the status register is not 
set* Branches are made relative to 
the instructions being branched to* 
The CPU will not let you branch 
further than 127 bytes* Branch 
instructions are the only 

instructions that use 

relative addressing ♦ 

Indexed {• LDA $?C4Q*X J Add the value in X to $9C4Q* 

Load the accumulator with the 

contents of the total 
of <$?C4Q+X)* 

LDA SCREEN* Y J Add the contents of the Y 

register to the address assigned 
to the label SCREEN ♦ 
Load the accumulator with the 
contents of the new address* 
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Indirect Indexed * LDA ($58) *Y }Get the address stored in 

$58 and $59 on the zero page 
of Memory ♦ Add the value 
in Y to the address ♦ 
Load the accumulator 
with the contents 
of the new address ♦ 



Indexed Indirect : LDA <$5S*X) JAdd the value in X to $58* 

Suppose X is 2* 
X + $58 = $5A* 
Get the address 
stored on the zero page 
in $5A and $5B* 
Load the accumulator 
with the contents of 
the address stored 
in $60 and $61* 



The appendices of the Atari Assembler Editor Manual 
include listings of the 6502 instruction set and their 
corresponding addressing modes and opcodes* 

The appendices of The Atar i Assembler » by Don and Kurt 
Inman* include the 6502 instruction set* addressing modes* 
opcodes* and the status flags affected by each instruction* 
You can find a copy of The Atari Assembler in the C3mp 
library* 



To learn how to save your assembly language programs on 
disk* see pages 19-23 of the Atari Assembler Editor User 's 
Manual ♦ 
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Chal lenges 



1* Write an 3sseMbly language program that prints your nane 
in the Middle of the screen* Use the *BYTE psuedo opcode and 
indexed addressing to print your naMe* 



2* In the animation prograMs* we are continually changing 
the address of screen RAM held in $58 and $59 to the updated 
position of the pinwheel* Memory locations $58 and $59 are 
the locations the computer uses to hold the starting address 
of screen RAM* When a break occurs in the animation program * 
the computer uses the address it finds in $58 and $59 for the 
starting location on the screen* Consequently* after a break 
in an animation prograM* the screen looks as though it has 
new Margins and print is oddly formated on the screen because 
the address in $58 an $59 was the last position of the 
pinwheel* Edit the ANIMATE program so that the address in 
$58 and $59 will be preserved* Store the starting address of 
screen RAM in two consecutive Memory locations on the zero 
page* MeMory locations $CB-$CF are free bytes of MeMory* 
Whenever the pinwheel is Moved* update your own screen 
address rather than interfering with the address stored at 
$58 and $59* 



3* Instead of leaving a zero in each of the pinwheel 's last 
locations in order to erase the last line of the pinwheel* 
save what was stored in the screen MeMory location before 
putting the pinwheel there* Save the original contents of 
the MeMory location on the stack* draw the pinwheel* and then 
recover the original contents of MeMory to its former 
location* For exaMple* if there is an A displayed on the 
screen and the pinwheel is about to Move into the A's 
position* push the A onto the stack* and then display the 
pinwheel* Then pull the A off the stack and store it back in 
its original screen MeMory location* This way the pinwheel 
will not erase everything in its path* Instead the screen 
display will be left intact* 



<l* Add soMe coMparisons to the direction subroutines that 
stop the pinwheel at the edge of the screen* Do not let it 
wrap around or write over MeMory above or below screen RAM* 



5 * R e a d t h e Joys t i c k f o f d i a g o n a 1 j o y s t i c k p r esse s ♦ 
Incorporate the necessary routines to Move the pinwheel on a 
d i a g o n a 1 as w e 1 1 a s u p a n d d o w n a n d 1 e f t a n d r i g h t * 



6* Animate a shape Made up of keyboard control characters* 
which is three or four characters wide and high* 
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r 



0000 
060 0 
0602 
0605 



A97D 

8D409C 

60 



50 i 
0100 
0110 
0120 
0130 



ARROW 

x= 
LDA 
STA 
RTS 



$0600 ORIGIN DF PROGRAM 

*$7D JLOAD ACC. WITH ARROW 

$9C40 # SCREEN RAM LOCATION 

J RETURN FROM SUBROUTINE 



25 } ARW2 
50 , 



0000 




0100 


x= 


$0600 


; ORIGIN OF PROGRAM 


0600 


A97D 


0110 


LDA 


#*7D 


J LOAD ACC ♦ WITH ARROW 


0602 


8Df09C 


0120 


STA 


$9C40 


\ SCREEN RAM LOCATION 


0605 


A900 


0130 


LDA 


*$0Q 


J LOAD ACC* WITH SPACE 


0607 


BD409C 


0140 


STA 


$9C40 


, STORE SPACE OVER ARROW 


060A 


60 


0150 


RTS 




J RETURN FROM .SUBROUTINE 



r 



SCRADR 



0000 0100 *= 

9C40 0105 SCREEN - 

0600 A97D 0110 LDA 

0602 8D409C 0120 STA 

0605 60 0130 RTS 



$060 0 i ORIGIN OF PROGRAM • 

$9C40 ; ASSIGN SCREEN 

#*7D J LOAD ACC* WITH ARROW 

SCREEN J STORE ACC. ON SCREEN 

t RETURN FROM SUBROUTINE 



HOLDARROW 



000 0 




0100 




x= 


$600 


; ORIGIN 


9C40 




0110 


SCREEN 




*9C40 




060 0 


A000 


0120 




LDY 


*$0 0 


,SET COUNTER 


06 02 


A97D 


0130 




LDA 


*$7D 


JCODE FOR ARROW 


0604 


SD309C 


0140 




STA 


SCREEN 


DISPLAY 


0607 


C8 


0150 


DELAY 


INY 




J ADD ONE TO Y » COUNTER 


0603 


O0FD 


0160 




BNE 


DELAY 


{IF NOT 0, THEN REPEAT 


060A 


60 


0170 




RTS 




i RETURN 
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0000 
9C40 
0600 
0602 
0605 
0608 
060? 
0608 
060D 
060E 
060F 
0610 
0611 



A200 
BD0E06 
8D409C 
E8 

E0 04 

D0F5 

60 

7C 

OF 

00 

3C 



10 
15 
20 
25 
30 
35 
40 
45 
50 
55 
60 
65 
0100 
0110 
0120 
0130 
0140 
0150 
0160 
0170 
0180 
0190 



PINWHEEL 

THIS PROGRAM USES THE .BYTE 
PSUEDO OPCODE TO STORE DATA 
IN MEMORY AND INDEXED ADDRESSING 
TO READ THROUGH THE DATA. 
THE PURPOSE OF THE PROGRAM IS 
TO DISPLAY A SPINNING PINWHEEL 
IN THE UPPER LEFT HAND CORNER 
OF THE SCREEN. 



x=» $600 

SCREEN = $9C40 

LDX #$0 0 
NEXTCHAR LDA CHAR,X 

STA SCREEN 

INX 

CPX **4 

BNE NEXTCHAR 

RTS 



; ORIGIN 

? screen ram ' 

♦,set index to 0 
j get next char 

j display it 
;add one to index 

j compare x reg. to 4 

i if x=4 then branch for char 

t RETURN 



CHAR 



♦BYTE 124, 15, 13,60 J PINWHEEL 



10 i SUBROUTINE'. 

20 I THIS PROGRAM PRINTS AN ARROW IN 

30 JTHE UPPER LEFT HAND CORNER OF THE 

40 J SCREEN. A CALL TO A DELAY LOOP 

50 JHOLDS THE ARROW ON THE SCREEN 

60 » 

70 ; 



0000 




0100 




Xs 


$600 




9C40 




0110 


SCREEN 




$9C40 




0600 


A97D 


0120 




LDA 


*$7D 


JCODE FOR AN ARROW 


0602 


8D409C 


0130 




STA 


SCREEN 


J DISPLAY 


0605 


200906 


0140 




JSR 


DELAY 


t WAIT 


0608 


60 


0150 
0160 
0170 
0180 


♦ 

♦ 
t 
♦ 


RTS 




J RETURN 


0609 


A2A0 


0190 


DELAY 


LDX 


**A0 


J COUNTER FOR Y LOOPS 


060B 


A000 


0200 


AGAIN 


LDY 


**0 0 


J0-FF COUNTER 


060D 


C8 


0210 


WAIT 


INY 




;add one to y 


060E 


D0FD 


0220 




BNE 


WAIT 


J IF NOT 0, REPEAT WAIT 


0^*1 


CA 


0230 




DEX 




SUBTRACT ONE FROM X 


D0F8 


0240 




BNE 


AGAIN 


J IF NOT 0, REPEAT AGAIN 


0613 


60 


0250 




RTS 




t RETURN 



r 



10 

20 
30 
40 
50 
60 
70 
80 
90 



SPIN 

THIS PROGRAM USES FOUR LINES 
TO PRINT A SPINNING PINWHEEL 
IN THE UPPER LEFT HAND CORNER 
OF THE SCREEN. THE PINWHEEL 
SPINS ONCE. 







0100 


* 
t 






- 






0110 


» 
t 








0000 




0120 




Xs 


$600 


; ORIGIN 


9C40 




0130 


SCREEN 




*9C40 


1 SCREEN RAM 


0600 


A200 


0140 


DRAW 


LDX 


**00 


J SET INDEX TO 0 


0602 


B01506 


0150 


NEXTCHAR LDA CHAR,X 


J GET NEXT CHAR 


0605 


8D409C 


0160 




STA 


SCREEN 


t DISPLAY IT 


0608 


8A 


0170 




TXA 




J TRANSFER X TO ACC. 


060? 


48 


0180 




PHA 




?PUSH ACC. ONTO STACK 


060A 


201906 


0190 




JSR 


DELAY 


»CALL DELAY LOOP 


0600 


68 


0200 




PLA 




J PULL ACC. OFF STACK 


060E 


AA 


0210 




TAX 




^TRANSFER ACC. TO X 


060F 


E8 


0220 




INX 




;add one to index 


0610 


E004 


0230 




CPX 


**4 


* COMPARE X REG. TO 4 


0612 


OOEE 


0240 




BNE 


NEXTCHAR 


JIF X=4 THEN BRANCH FOR 




60 


0250 




RTS 




J RETURN 


7C 


0260 


CHAR 


♦BYTE 124, 15 , 


13,60 J PINWHEEL 


"616 


OF 






V 






il7 


OD 












0618 


3C 












0619 


A255 


0270 


DELAY 


LDX 


*SS5 


» COUNT 0-255 , $55 TIMES 


0618 


AOOO 


0280 


AGAIN 


LDY 


#$0 0 


JSET COUNTER TO 0 


0610 


C8 


0290 


WAIT 


INY 




^INCREMENT Y REG. 


061E 


DOFD 


0300 




BNE 


WAIT 


?IF NOT 0.WAIT 


0620 


CA 


0310 




DEX 




t SUBTRACT 1 FROM' X 


0621 


D0F8 


0320 




BNE 


AGAIN 


J IF NOT 0, AGAIN 


0623 


60 


0330 




RTS 




JRETURN 
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r 



0000 
0 058 
0059 



0600 200C06 

0603 203-106 

0606 202606 

0609 4C0006 



060C 
060E 
0610 
0613 
0615 
0616 
0617 
061A 
OolB 
061C 
061D 
061F 
0621 
0622 
0623 
0624 
0625 



A200 

A000 

BD2206 

9158 

8A 

48 

203406 
68 
AA 
E8 

E004 

DOEF 

60 

7C 

OF 

OD 

3C 



0<Sf A558 

0628 18 

0629 6901 



10 
20 
30 
40 
50 
60 
70 
80 
90 

0100 
0110 
0120 
0130 
0140 
0150 
0160 
0170 
0180 
0190 
0200 
0210 
0220 
0230 
0240 
0250 
0260 
0270 
0280 
0290 
0300 
0310 
0320 
0330 
0340 
0350 
0360 
0370 
0380 
0390 
0400 



0410 
0420 
0430 
0440 
0450 



ANIRIGHT 

THIS PROGRAM MOVES THE SPINNING 
PINWHEEL TO THE RIGHT , BY 
CONTINUALLY INCREMENTING THE 
SCREEN RAM POSITION* 



LOWSCR - 
HISCR = 



$600 

*58 

$59 



MAIN LOOP 



BEGIN JSR DRAW 

JSR DELAY 

JSR RIGHT 

JMP BEGIN 



{LOW BYTE OF SCREEN RAM 
{HIGH BYTE OF SCREEN RAM 



{DRAW THE PINWHEEL 
{HOLD ON THE SCREEN MOMENTARILY 
{INCREMENT POSITION TO THE RIGHT 
{REPEAT MAIN LOOP 



DRAW READS CHAR DATA AND 
PLACES LINES ON SCREEN IN 
SEQUENCE TO APPEAR LIKE 
SPINNING PINWHEEL, 



DRAW LDX **00 {SET INDEX TO 0 

LDY **0 0 {SET INDEX TO 0 

NEXTCHAR LDA CHAR,X {INDEXED ADDRESSING, GET DATA 

STA (LOWSCR) ,Y {INDIRECT INDEXED ADDRESSING TO SCREEN 

{TRANSFER X REG ♦ TO ACC. 
{PUSH ACC. ONTO STACK 
{CALL THE DELAY ROUTINE 
{PULL ACC OFF STACK 
{TRANSFER ACC, TO X REG* 
{ INCREMENT X REGISTER 
{4 LINES IN PINWHEEL 
{GET NEXT CHAR 
{RETURN 



TXA 
PHA 
JSR 
PLA 
TAX 
INX 
CPX 
BNE 
RTS 



DELAY 



**4 

NEXTCHAR 



CHAR .BYTE 124,15,13,60 {PINWHEEL 



RIGHT ADDS ONE TO THE SCREEN 
ADDRESS OF THE PINWHEEL 



0460 RIGHT LDA LOWSCR 
0470 CLC 
0480 ADC **1 



{GET LOW BYTE OF SCREEN RAM 
{CLEAR THE CARRY 
{ ADD 1 AND CARRY TO ACC. 
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per crp 


n 4Q n 

U *T 7 u 




STA 


LOWSCR 


J UPDATE LOWSCR 




AC-cg 
R*J*J 7 


U JUU 




LDA 


HISCR 


t GET HIGH BYTE OF SCREEN 


U oZr 


orU u 


0510 




ADC 


#*00 


J ADD 0 AND CARRY 


0631 


855V 


0520 




STA 


HISCR 


J UPDATE HIGH BYTE SCREEN 


0633 


60 


0530 
0540 
0550 




RTS 




J RETURN 






0560 


> DELAY HOLDS THE 


IMAGE 






0570 


\ IN 


ONE PLACE, MOMENTARILY 






0530 


J BEFORE THE NEXT 


MOVE. 






0590 














0600 










063* 


A219 


0610 


DELAY 


LDX 


**19 


JCOUNT 0-255, 25 TIMES 


0636 


A000 


0620 


AGAIN 


LDY 


**00 


J SET COUNTER TO 0 


0638 


C8 


0630 


WAIT 


INY 




J ADD 1 TO Y REG. 


0639 


D0FD 


0640 




BNE 


WAIT 


}IF NOT 0, WAIT 


063B 


CA 


0650 




DEX 




J SUBTRACT 1 FROM X REG. 


063C 


D0F8 


0660 




BNE 


AGAIN 


J*19 YET? 


063E 


60 


0670 




RTS ' 




J RETURN 



F 
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10 { 
20 { 


ERASE 








•30 ; 


THIS PROGRAM MOVES THE SPINNING 






40 ; 


PINWHEEL TO THE RIGHT 


f BY 






50 { 


CONTINUALLY INCREMENTING THE 






60 { 


SCREEN RAM POSITION ♦ 


EACH TIME 






70 { 


THE PINWHEEL IS DRAWN 


, A SPACE 






80 { 


IS PRINTED OVER THE LAST PINWHEEL 






90 { 


POSITION SO NOT TO LEAVE A TRAIL 






0100 










0110 


♦ 
t 




0000 




0120 


*= $600 




0 058 




0130 


LOWSCR « $58 


J LOW BYTE OF SCREEN 


0059 




0140 
0150 


HISCR ■ $5? 
♦ 


J HIGH BYTE OF SCREEN RAM 






0160 


{ MAIN LOOP 








0170 


* 

t 




0600 


200F06 


0180 


BEGIN JSR DRAW 


J DRAW THE PINWHEEL 


0603 


203E06 


0190 


JSR DELAY 


♦HOLD ON THE SCREEN MOMENTARILY 


0606 


203706 


0200 


JSR ERASE 


{ERASE LINE WITH SPACE 


0609 


202906 


0210 


JSR RIGHT 


{INCREMENT POSITION TO THE RIGHT 


060C 


4C0006 


0220 


JMP BEGIN 


{REPEAT MAIN LOOP 






0230 










0240 










0250 


{ DRAW READS CHAR DATA AND 






0260 


{ PLACES LINES ON SCREEN IN 






0270 


{ SEQUENCE TO APPEAR 


LIKE 


V 




0280 


{ SPINNING PINWHEEL. 








0290 










0300 






060F 


A200 


0310 


DRAW LDX #*00 


{SET INDEX TO 0 


0611 


A000 


0320 


LDY #*00 


{SET INDEX TO 0 


0613 


BD2506 


0330 


NEXTCHAR LDA CHAR,X 


{INDEXED ADDRESSING, GET DATA 


0616 


9158 


0340 


STA ( LOWSCR ),Y 


{INDIRECT INDEXED ADDRESSING TO 


0613 


8A 


0350 


TXA 


{ TRANSFER X REG, TO ACC, 


0619 


48 


0360 


PHA 


{PUSH ACC, ONTO STACK 


061A 


203E06 


0370 


JSR DELAY 


{CALL THE DELAY ROUTINE 


061D 


68 


0380 


PLA 


{PULL ACC OFF STACK 


061E 


AA 


0390 


TAX 


} TRANSFER ACC. TO X REG. 


061F 


E8 


0400 


INX 


{ INCREMENT X REGISTER 


0620 


E004 


0410 


CPX #*4 


{4 LINES IN PINWHEEL 


0622 


DOEF 


0420 


BNE NEXTCHAR 


{ GET NEXT CHAR 


0624 


60 


0430 


RTS 


{ RETURN 


0625 


7C 


0440 


CHAR . BYTE 124,15,13 


,60 { PINWHEEL 



0626 OF 

0627 0D 

0628 3C 

0450 { 

0460 { RIGHT ADDS ONE TO THE SCREEN 
0470 { ADDRESS OF THE PINWHEEL 
0480 { 
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0490 ; 



0629 


A558 


0500 


RIGHT 


LDA 


LOWSCR 




J GET LOW BYTE OF SCREEN RAM 




062B 


18 


0510 






CLC 






J CLEAR THE CARRY 




062C 


6901 


0520 






ADC 


#*1 




\ ADD 1 AND CARRY TO ACC. 




062E 


8558 


0530 






STA 


LOWSCR 




J UPDATE LOWSCR 




0630 


A559 


0540 






LDA 


HISCR 




»GET HIGH BYTE OF SCREEN 


RAM 


0632 


6900 


0550 






ADC 


#*0 0 




t ADD 0 AND CARRY 




0634 


8559 


0560 






STA 


HISCR 




J UPDATE HIGH BYTE SCREEN 


RAM 


0636 


60 


0570 
0580 
0590 






RTS 






J RETURN 








0600 




ERASE PUTS A SPACE 


OVER THE 








0610 




SPINNING 


PINWHEEL' 


S LAST POSITION. 








0620 




















0630 
















0637 


A000 


0640 


ERASE 


LDY 


#40 0 




J INDEX 




0639 


A900 


0650 






LDA 


#iM)0 




J VALUE FOR SPACE 




063B 


9158 


0660 






STA 


(LOWSCR) , 


Y } STORE IN LAST LOCATION 




063D 


60 


0670 
0680 
0690 


♦ 

♦ 

t 




RTS 






^RETURN 








0700 


♦ 

t 


DELAY HOLDS THE 


IMAGE 








0710 


♦ 

t 


IN 


ONE PLACE, MOMENTARILY 






0720 


* 


EEFORE THE NEXT 


MOVE . 








0730 


* 


















0740 


♦ 
t 














063E 


A225 


0750 


DELAY 


LDX 


#$25 




JCOUNT 0-255, $25 TIMES 




0640 


AOOO 


0760 


AGAIN 


LDY 


#*0 0 




JSET COUNTER TO 0 




0642 


C8 


0770 


WAIT 


INY 






J ADD 1 TO Y REG ♦ 




0643 


DOFD 


0780 






BNE 


WAIT 




ilF NOT 0, WAIT 




0645 


CA 


0790 






DEX 






t SUBTRACT 1 FROM X REG. 




0646 


D0F8 


0800 






BNE 


AGAIN 




J$19 YET? 




0643 


60 


0810 






RTS 






J RETURN 
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4C0306 



0000 
0600 
0278 
0 058 
0059 



0603 201206 
0606 203A06 
0609 205B06 
060C 205406 
060F 4C0306 



St., 

0617 
0619 
061B 
061D 
061E 
0620 
0621 
0623 
0625 
0627 
0629 
062B 
062C 
062E 
062F 
9631 
0633 
0635 
0637 
0639 



AD7802 

C907 

F005 

C90B 

F00F 

60 

A558 
13 

6901 
8558 
A559 
6900 
8559 
60 

A558 
38 

E901 
8558 
A559 
E900 
8559 
60 



10 
20 
30 
40 
50 
60 
70 
80 
90 

0100 
0110 
0120 
0130 
0140 
0150 
0160 
0170 
0180 
0190 
0200 
0210 
0220 
0230 
0240 
0250 
0260 
0270 
0280 
0290 
0300 
0310 
0320 
0330 
0340 
0350 
0360 
0370 
0330 
0390 
0400 
0410 
0420 
0430 
0440 
0450 
0460 
0470 
0480 
0490 
0500 
0510 



JOYMOVE 

THIS PROGRAM MOVES A SPINNING PINWHEEL TO THE LEFT 
OR THE RIGHT ON THE SCREEN* THE PINWHEEL ' S 
DIRECTION OF TRAVEL IS CONTROLLED 
BY THE JOYSTICK IN PORT #1. 



Xs 

JMP 
STICK = 
LOWSCR = 
HISCR = 

♦ 

! MAIN LOOP 



BEGIN 



JSR 
JSR 
JSR 
JSR 
JMP 



$600 

BEGIN J JUMP OVER VARIABLES AND CONSTANTS 

$278 J FEEDBACK FROM JOYSTICK *1 

$58 J LOW BYTE OF SCREEN RAM 

$59 i HIGH BYTE OF SCREEN RAM 



JOYSTICK J READ JOYSTICK SUBROUTINE 

DRAW J DRAW THE PINWHEEL 

DELAY J LEAVE ON THE SCREEN MOMENTARILY 

ERASE I ERASE WITH A SPACE 

BEGIN J JUMP TO BEGIN, REPEAT MAIN LOOP 



READ AND INTERPRET THE VALUE RETURNED FROM THE JOYSTICK 



JOYSTICK LDA 
CMP 
BEG 
CMP 
BEQ 
RTS 

RIGHT LDA 
CLC 
ADC 
STA 
LDA 
ADC 
STA 
RTS 

LEFT LDA 
SEC 
SBC 
STA 
LDA 
SBC 
STA 
RTS 



STICK 
#*7 
RIGHT 
#$B 
LEFT 

LOWSCR 

*$1 

LOWSCR 
HISCR 
*$0 0 
HISCR 

LOWSCR 

#$1 

LOWSCR 
HISCR 
*$0 0 
HISCR 



} DRAW READS CHAR DAT 
; ON SCREEN IN ORDER 
J A SPINNING PINWHEEL 



J LOAD ACC WITH CONTENTS OF $278 
}WAS IT PRESSED TO THE RIGHT? 
J IF YES BRANCH TO RIGHT ROUTINE 
I TO THE LEFT? 

JIF SO BRANCH TO LEFT ROUTINE 

J GET LOW BYTE OF SCREEN RAM 

; CLEAR THE CARRY BIT 

J ADD 1 AND CARRY TO ACC. 

J UPDATE LOWSCR 

J GET HIGH BYTE 

i ADD CARRY AND ZERO TO HIGH BYTE 



} GET LOW BYTE OF SCREEN RAM 

JSET THE CARRY BIT 

J SUBTRACT 1 AND CARRY 

t GET HIGH BYTE SCREEN RAM 

> ANYTHING IN CARRY TO SUBTRACT? 

J UPDATE HIGH BYTE SCREEN RAM 



ft AND PLACES LINES 
OF SEQUENCE TO APPEAR LIKE 
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063A 


A200 


0520 


DRAW LDX 


#*0 0 


J SET INDEX TO 0 


063C 


A000 


0530 


LDY 


**00 


{ INDEX 


063E 


BD5006 


0540 


NEXTCHR LDA 


CHAR,X 


{ INDEXED ADDRESSING 


0641 


9153 


0550 


STA 


(LOWSCR) ,Y 


{INDEXED INDIRECT ADDRESSING 


0643 


8A 


0560 


TXA 




{TRANSFER X TO ACC. 


0644 


48 


0570 


PHA 




J PUSH ACC» ONTO STACK 


0645 


205B06 


0580 


JSR- 


DELAY 


{JUMP TO DELAY ROUTINE 


0648 


63 


0590 


PLA 




{PULL ACC. OFF STACK 


0649 


AA 


0600 


TAX 




{TRANSFER ACC* TO X REG . 


064A 


E8 


0610 


INX 




{INCREMENT X 


064B 


E004 


0620 


CPX 


fc*4 


{4 LINES IN PINWHEEL 


064D 


DOEF 


0630 


BNE 


NEXTCHR 


{GET NEXT ONE 


064F 


60 


0640 


RTS 






0650 


7C 


0650 


CHAR . BYTE 124,15,13 


,60 {VALUES FOR LINES 


0651 


OF 










0652 


OD 










0653 


3C 


0660 


♦ 
> 










0670 


{ ERASE PUTS A SPACE 


OVER THE SPINNING 






0680 


{ PINWHEELS LAST POSITION 


o£ i 


AOOO 


0690 
0700 


♦ 

ERASE LDY 


**0 0 


{INDEX FOR ZERO PAGE ADDRESSING 


0656 


A90 0 


0710 


LDA 


**0 0 


{ VALUE FOR SPACE 


0653 


9158 


0720 


STA 


(LOWSCR) , Y 


} STORE IN LAST LOCATION 


065A 


60 


0730 
0740 


RTS 

* 
t 










0750 


{ DELAY HOLDS THE IMAGE IN ONE PLACE MOMENTARILY 






0760 


{ BEFORE READING NEXT 


MOVE 






0770 


♦ 






065B 


A219 


0780 


DELAY LDX 


#*19 


{COUNT 0-255 25 TIMES 


065D 


AOOO 


0790 


AGAIN LDY 


**0 0 




065F 


C3 


0300 


WAIT INY 




{INCREMENT Y REGISTER 


0660 


DOFD 


0810 


BNE 


WAIT 


{IF NOT ZERO, WAIT 


0662 


CA 


0820 


DEX 




5 25 YET? 


0663 


D0F3 


0830 


BNE 


AGAIN 


{IF NOT ZERO, AGAIN 


0665 


60 


0840 


RTS 







Copyright Atari, Inc. 1983 All rights reserved. 



r 







10 } 




ANIMA 






20 * 










30 JTHIS PROGRAM 


MOVES A S 






40 J GRAPHICS ZERO SCREEN » 






50 J JOYSTICK PLUGGED INTO 






60 \ 










70 i 










80 t 










90 *, 






0000 




0100 


*ss 


$600 


0600 


4C0306 


0110 


JMP 


BEGIN 


0278 




0120 


STICK = 


$278 


0 058 




013-0 


LOWSCR = 


$58 


0059 




0140 
0150 
0160 
0170 


HISCR • 

♦ 

J MAIN LOOP 

♦ 


$59 


0603 


201206 


0180 


BEGIN JSR 


JOYSTICK 


0606 


205E06 


0190 


JSR 


DRAW 


0609 


207F06 


020 0 


JSR 


DELAY 


060C 


207806 


0210 


JSR 


ERASE 


060F 


4C0306 


noon 
U 22 0 

U/CoU 


JMP 

♦ 


BEGIN 






UZ*tU 


t READ AND 


INTERPRET 


V 




U jL%J 0 


♦ 
t 




ft / * *^ 

0612 


a r\ *y n ft o 

AD7802 


ft*? / ft 

U 26U 


JOYSTICK LDA STICK 


0615 


C907 


ft OT ft 

02/0 


CMP 


#$7 


0617 


FOOD 


ft O O ft 

0280 


BEQ 


RIGHT 


0619 


C90B 


ft O /"> ft 

0290 


CMP 


#$B 


061B 


F017 


0300 


BEQ 


LEFT 


061D 


C90E 


0310 


CMP 


#$E 


061F 


F021 


0320 


BEG 


UP 


0621 


C90D 


0330 


CMP 


#$D 


0623 


F02B 


0340 


BEQ 


DOWN 


0625 


60 


0350 


RTS 




0626 


A558 


0360 


RIGHT LDA 


LOWSCR 


0623 


13 


0370 


CLC 




0629 


6901 


0380 


ADC 


#$1 


062E: 


8558 


0390 


STA 


LOWSCR 


062D 


A559 


0400 


LDA 


HISCR 


062F 


6900 


0410 


ADC 


#$0 0 


0631 


3559 


0420 


STA 


HISCR 


0633 


60 


0430 


RTS 




1634 


A558 


0440 


LEFT LDA 


LOWSCR 


0636 


38 


0450 


SEC 




0637 


E901 


0460 


SBC 


#il 


0639 


8553 


0470 


STA 


LOWSCR 


063B 


A559 


0480 


LDA 


HISCR 


063D 


E900 


0490 


SBC 


#$0 0 


062F 
if* 


8559 


0500 




HISCR 


60 


0510 


© t q 





THE PINWHEEL IS CONTROLLED BY A 



t JUMP OVER VARIABLES AND CONSTANTS 
J FEEDBACK FROM JOYSTICK #1 
J LOW BYTE OF SCREEN RAM 
J HIGH BYTE OF SCREEN RAM 



J READ JOYSTICK SUBROUTINE 

J DRAW THE PINWHEEL 

I LEAVE ON THE SCREEN MOMENTARILY 

i ERASE WITH A SPACE 

5JUMP TO BEGIN t REPEAT MAIN LOOP 



1 LOAD ACC WITH CONTENTS OF $278 
JWAS IT PRESSED TO' THE RIGHT? 
J IF YES BRANCH TO RIGHT ROUTINE 
J TO THE LEFT? 

JIF SO BRANCH TO LEFT ROUTINE 
J 14 FOR UP? 

;i3 FOR DOWN? 



\ GET LOW BYTE OF SCREEN RAM 

\ CLEAR THE CARRY BIT 

i ADD 1 AND CARRY TO ACC. 

t UPDATE LOWSCR 

J GET HIGH BYTE 

JADD CARRY AND ZERO TO HIGH BYTE 



;get low byte of screen ram 

t SET THE CARRY BIT 

t SUBTRACT 1 AND CARRY 

JGET HIGH BYTE SCREEN RAH 

t ANYTHING IN CARRY TO SUBTRACT? 

: UPDATE HIGH BYTE SCREEN RAM 
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06tZ 


A558 


0520 UP 


LDA 


LOWSCR 


{ LOAD ACC, WITH LOW BYTE 


0644 


38 


0530 


SEC 




{ SET THE CARRY BIT 


0645 


E928 


0540 


SBC 


**28 


{SUBTACT 40 FROM ACCUMULATOR 


0647 


8558 


0550 


STA 


LOWSCR 




0649 


A559 


0560 


LDA 


HISCR 




064B 


E900 


0570 


SBC 


t$00 


J SUBTRACT ZERO AND CARRY 


064D 


8559 


0580 


STA 


HISCR 




064F 


60 


0590 


RTS 






0650 


A558 


0600 DOWN 


LDA 


LOWSCR 


{GET LOW BYTE OF SCREEN RAM 


0652 


18 


0610 


CLC 




{CLEAR THE CARRY 


0653 


6928 


0620 


ADC 


**28 


{ADD 40 <*28) FOR EACH LINE 


0655 


8558 


0630 


STA 


LOWSCR 




0657 


A559 


0640 


LDA 


HISCR 


{get high byte screen ram 


065? 


6900 


0650 


ADC 


**00 


{add any carry 


065B 


8559 


0660 


STA 


HISCR 


J UPDATE HIGH BTYE 


065D 


60 


0670 


RTS 







065E 
0660 
0662 
0. 
0< 
0668 
0669 
066C 
066D 
066E 
066F 
0671 
0673 
0674 
0675 
0676 
0677 



A200 

A000 

BD7406 

9158 

8A 

48 

207F06 
68 
AA 
E8 

E004 

D0EF 

60 

7C 

OF 

0D 

3C 



0678 A000 
067A A900 
067C 9158 
067E 60 



Ojp? A219 
01 . A000 



0680 
0690 
0700 
0710 
0720 
0730 
0740 
0750 
0760 
0770 
0780 
0790 
0800 
0810 
0820 
0830 
0840 
0850 
0860 



0870 
0880 
0890 
0900 
0910 
0920 
0930 
0940 
0950 
0960 
0970 
0980 
0990 
1000 



DRAW READS CHAR DATA AND PLACES LINES 

ON SCREEN IN ORDER OF SEQUENCE TO APPEAR LIKE 

A SPINNING PINWHEEL 



DRAW LDX **00 

LDY **00 
NEXTCHR LDA CHAR,X 

STA (LOWSCR), Y 



CHAR 



TXA 
PHA 

JSR DELAY 
PLA 
TAX 
INX 

CPX *$4 
BNE NEXTCHR 
RTS 

♦ BYTE 124,15,13,60 { VALUES FOR LINES 



{SET INDEX TO 0 
{ INDEX 

J INDEXED ADDRESSING 
; INDEXED INDIRECT ADDRESSING 
{TRANSFER X TO ACC, 
{ PUSH ACC* ONTO STACK 
{JUMP TO DELAY ROUTINE 
{PULL ACC, OFF STACK 
{TRANSFER ACC. TO X REG. 
{INCREMENT X 
{4 LINES IN PINWHEEL 
{GET NEXT. ONE 



ERASE PUTS A SPACE OVER THE SPINNING 
PINWHEELS LAST POSITION 



ERASE 



LDY 
LDA 
STA 
RTS 



**00 
**0 0 

(LOWSCR) ,Y 



{INDEX FOR ZERO PAGE ADDRESSING 
{ VALUE FOR SPACE 
{STORE IN LAST LOCATION 



DELAY HOLDS THE IMAGE IN ONE PLACE MOMENTARILY 
BEFORE READING NEXT MOVE 



DELAY 
AGAIN 



LDX 
LDY 



**19 
#400 



{ COUNT 0-255 25 TIMES 
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C8 


1010 WAIT 


INY 




\ INCREMENT Y REGISTER 


0684 


DOFD 


1020 


BNE 


WAIT 


}IF NOT ZERO t WAIT 


0686 


CA 


1030 


DEX 




J 25 YET? 


0687 


D0F3 


. 1040 


BNE 


AGAIN 


J IF NOT ZERO, AGAIN 


0689 


60 


1050 


RTS 
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INTERNAL CHARACTER SET 



Column 1 


Column 2 


Column 3 


Column 4 


a 


C1IR 


u 


CI lit 


a 


CI 111 


a 


CUR 


ff C1IR 




CUR 




CUR 


ff 


CUR 


0 


Space 


16 


0 


32 


@ 


40 


P 


64 Q 


00 


0 


96 


o 


112 


P 


1 


! 


17 


1 


33 


A 


49 


Q 


65 © 


fli (9 


97 


a 


113 


fl 


2 


»» 


10 


2 


34 


11 


50 


R ! 


66 0) 


02 


CESS 

GJ | 


90 


b 


114 


r 


3 


u 


10 


3 


35 


C 


51 


s 


67 | 


SI 


03 




99 


c 


115 


s 


4 


$ 


20 


4 


36 


D 


52 


T 


GO 


04 


o 


100 


(1 


116 


1 


5 


% 


21 


5 


37 


E 


53 


u 




05 


B 


101 


c 


117 


ii 


G 




22 


6 


30 


F 


54 


V 




06 


03 


102 


r 


110 


V 


7 


• 


23 


7 


39 


G 


55 


w 


7. gj 




103 


g 


119 


w 


fl 


( 


24 


0 


40 


II 


56 


X 


7* 0 


00 


© 


104 


h 


120 


X 


9 


) 


25 


9 


41 


1 


57 


Y 


73 


m 


69 03 


105 


i 


121 


y 


10 


• 


26 : 


42 


J 


50 


Z 


74 eg 


90 


O 


106 


j 


122 


z 


11 


+ 


27 


» 


43 


K 


59 


I 


75 0 


91 


•© 


107 


k 


123 




12 


> 


20 


< 


44 


L 


60 


\ 


76 




92 




100 


1 


124 


1 


13 




29 




45 


M 


61 


] 


77 j 


B 


93 


o 


109 


m 


125 




14 




30 


> 


46 


N 


62 


A 


70 I 






110 


n 


126 




15 


/ 


31 


? 


47 


O 


63 




79 




95 (3 


111 


. o 


127 





I. In mode 0 llieoc characters must be preceded willi an escape, CIIRSU7), lo lie printed. 



